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OS/VS VSAM FOR SYSTEM PROGRAMMERS 


Duration: Four days 


Audience: Personnel performing the functions of VSAM systen 
programming. implementation and design. 


Recommended Background: Knowledge of IBM direct access devices and 
VSAM coding. Attendees should have a knowledge of the various 
data set formats supported by VSAM and how they are defined. They 
should also understand the various methods of accessing data and 
have a familiarity with the basic functions of VSAM Access Method 
Services. This knowledge may have been obtained by completion of 
the course DASD Data Management (H3720) of VSAM Coding 
(A3750) or VSAM ISP's or equivalent experience. 


Prerequisite Test: Yes 


Coerse Abstract: This course is intended to build upon the students 
knowledge of VSAM to a level at which they, as system programmers 
can efficiently install and implement VSAM. The student should 
become familiar with the VSAM catalog structure and use. and be 
able to define and maintain the Master and User catalogs. In addition 
to defining a data set. the student should become familiar with 
defining Alternate Indexes and Paths and how to access the data using 
Alternate Indexes. The student should become knowledgeable in 
catalog and data set recovery. including the use of the catalog 
recovery area. The student should be able to fully utilize VSAM 
Access Method Services and be able to select those VSAM options 
and processing techniques which will provide for proper utilization of 
VSAM. They will be given a functional overview of VSAM control 
blocks and be able to design a VSAM data set for better uthization of 
space, portability and performance. How to protect catalogs and data 
sets will also be covered. Throughout the course suggested standards 
for using VSAM will be presented to assist easier implementation and 
use of VSAM. This course ts for those using OS/MVS OS/VS§2 
Release |. and OS/VSI 


[A3754] 
Tuition: $565 


Course Objectives: Upon completion of this course the student should be 
able to: 


|. Create and maintain Master and User Catalogs. 

2. Calculate space required for Catalogs and Data Sets. 

3. Cite catalog and data set recovery methods and techniques. 

4. State the relationships between define options and their effect on 
optimization including the impact of control interval and control 
area sizes. 

5. Interpet an Access Method Services print listing of a VSAM 
catalog. 

6. Identify those factors and standards necessary to successfully 
install and use VSAM. 

7. Utilize the security and integrity features of VSAM. 

8. State the requirements necessary to properly utilize the sharing 
capabilities of VSAM between. Jobs. Systems. and Subtasks. 

9. State the differences of VSAM in MVS. 

10. Define and use Alternate Index capability. 


Course Topics: 


VSAM Catalogs 

Recovering VSAM Catalogs and Data Sets 

VSAM Data Set Optimization Considerations 

Security and Integrity 

Special Processing 

VSAM Sharing 

Access Methods Services - throughout the course where appropriate. 
MVS Considerations 

Alternate Indexes 


Competer Exercises: To provide the student with experience in: (1) 
Defining and accessing » duta set with Alternate Indexes and Paths. 
(2) recovery of a data set, using Acess Method Services. 





H.1.1 
VSAM OBJECTIVES 
IMPROVED PERFORMANCE 
SINGLE ACCESS METHOD FOR PROCESSING MODES 
CROSS SYSTEM COMPATIBILITY (DOS-OS) 
NEW DATA ORGANIZATION 
SIMPLE TO USE JCL 
ALL DATA SETS MUST BE CATALOGED 
IMPROVED RELIABILITY 
VSAM SUPPORTED BY VS PROGRAM PRODUCTS (DOS/OS) 
CONVERSION WITH ISAM INTERFACE 
H.1.2 


VSAM FEATURES AND BENEFITS 


DATA SECURITY 
DATA INTEGRITY 
PHYSICAL RECORD MOVEMENT MINIMIZED 
SOFTWARE EOF 
DEVICE INDEPENDENCE WITH CI/CA TYPE OF DATA STRUCTURE 
DECREASED FILE REORGANIZATION 
ERROR RETURN CODES INSTEAD OF ABENDS 
TYPES OF ACCESS 
KEY 
ADDRESS — (RBA) 
CONTROL INTERVAL — CI (RBA) 
RELATIVE RECORD NUMBER 
DATA PORTABILITY BETWEEN SYSTEMS 
OS/VS — DOS/VS 


H.1.3 


eer ne 


REVIEW OF VSAM DATA ORGANIZATION 


THREE TYPES OF DATA SETS 
® KSDS KEY SEQUENTIAL DATA SET 


2 SEPARATE VSAM COMPONENTS DATA AND 
INDEX ACCESS BY KEY OR ADDRESS 


DISTRIBUTED FREE SPACE Cl AND CA 
RECORDS ARE PHYSICALLY MOVED AND DELETED 
@® SDS ENTRY SEQUENCE DATA SET 
DATA COMPONENT ONLY NO KEYS OR INDEX 
ACCESS BY ADDRESS 
ADDITIONS ADDED TO END OF THE DATA SET 
RECORDS ARE NOT MOVED OR DELETED 
@® RELATIVE RECORD DATA SET 
FIXED LENGTH RECORDS ONLY 
VIEWED AS A STRING OF SLOTS 
ACCESS IS BY RELATIVE RECORD NUMBER 
ADDITIONS ARE TO EMPTY SLOTS 
DELETIONS MARK A SLOT AS EMPTY 
RECORDS ARE NOT MOVED 
NO FREE SPACE 
EACH Cl CONTAINS THE SAME NUMBER OF SLOTS H.1.4 
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c Control Interval 
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e Unit of transmission between virtual storage and DASD. 


NORM 


e Length is system-determined. 
User can request a specific length. 
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CONTROL AREA SIZE 


IF ALLOCATION IS BY: 


CY: TRACKS PER CYL 
TRACKS: MIN (PRIMARY,SECONDARY) 
RECORDS: MIN (PRIMARY,SECONDARY) 


= H.1.6 


@- apie 8 
: CONTROL INTERVAL SIZE 
e DATA COMPONENT 
UP TO 8K — MULTIPLE OF 512 
OVER 8K — MULTIPLE OF 2048 
MAXIMUM — 32768 
© INDEX COMPONENT 
512, 1024, 2048, 4096 (3330 AND 3340 ONLY) 
pee ! 
( if ( ( ye % j 
Sante pe 
H.1.7 
hd 


CI/PHYSICAL BLOCK RELATIONSHIPS 


e PHYSICAL BLOCK SIZES VSAM USES: 
512, 1024, 2048, 4096 


4096 IS INVALID FOR 2314 


CONTROL INTERVAL PHYSICAL BLOCK NUMBER OF 
as SIZE BLOCKS/CI 


A SOA aa SN 
3072 


j 3584 51 PID 
4096 
4096 
2048 
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PHYSICAL BLOCK — DASD CAPACITY 
3330 COMP. 


RECDS RECDS RECDS RECDS 
oe aie TRK isle PER TRK ae eae TRK Tea ee TRK Ta 










which is why 
VSAM doesn’t 
use it! 
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Index Structure 


Index 





nose case rr 10080 | Fre 4 
Area 
iat = [ 10300] 10333 | Fre 


Control 








Free Space yy 
[10334 | 13000 | 13500] 14000 | Fre 
Control 
Areo 


SS 


23456 | 23500 | 23525 | 23630 | Free _| 


Free Space 


Sy 
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INDEX RECORD FORMAT 


HEADER FREE FREE 
PTR* | PTR* 


"EXISTS ONLY IN SEQUENCE SET RECORDS 


ZO-AMQMMN 
<DiAZwzMm 
<DiAZwmM 
<DiAwzmMm 
<DiAwzmMm 
Zzo7AdamMMN 
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INDEX ENTRY 

Total Length 
of 3 Fields 
is in Header 

(V) 

Key 

Pointer 
| a Se eee * 
—, 
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3 
# OF INDEX ENTRIES PER CI SIZE 
58 512 
120 1024 
248 2048 
502 4096 
H.1.13 
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VSAM FEATURES AND BENEFITS 
ACCESS METHOD SERVICES 


CHARACTERISTICS 
DATA SET UTILITY 
INTERFACE TO VSAM AND THE CATALOG 


INVOKED BY 
JCL 
TSO TERMINAL 


H 1.14 
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ACCESS METHOD SERVICES 


The following is a coding example of invoking Access Method Services 


within the program. 


S/STEP 1 


EXEC 


//ASH.SYSIN DD 


CSECT 


TvkOUT 





sw 


END 
OPENCLOS 


SAVE 
SVAE2 
OPTICH 
DONANE 
PAGE 
IOLIST 


COPMAND 
DDCARD 


START 
SAVE 


BRE 
NOP 
MVI 

L 

AYC 
MVC 

L 
RETORN 
L 
RETORN 


te 


RETURN 


END 


ASMFCLG 
® 


(14, 12) 
12,0 

*,12 
11,SAVE 
13,SAVE44 
11,8 (13) 
13,11 


This example is a LISTCAT ALL command. 


EP=IDCAMS, PARAM=(QOETION, DDNAME, PAGE, IOLIST) , VL=1 


13,SAVE+4 
(14,12) ,RC=0 
(14, 12) 
10,0 
*,10 
13,SVAE2¢4 
11,SAVE2 
11,8 (13) 
13,11 
3,4 (1) 

a 


e 
4,0(3) 
4 ,=F'S8? 
OPENCLOS 
END 
Sue1,x*FO?* 
6 ,8(1) 
0 (4,6) , =A (COMMAND) 
4&(4,6) ,=F* 80° 
13,SAVE2¢4 
(14,12) ,RC=0 
13,SAVE2+4 
(14,12) ,RC=4 
13,SAVE2+¢4 
(14,12) ,RC=0 
18F*O° 
18F*O8 
hn 
H* O° 
H*Q* 
Fe! 
A (DDCARC) 
A (IN ROUT) 
F° Oo? 
CL8O"LISTC ALL* 
CL10*DDSYSIN® 


//GO.~SYSPRINT DD SYSOUT=A 


I/O ROUTINE 


REG3 - PTR I/O FLAGS 


REG4 - CODE INDICATING OPERATION 
TEST CODE 8 - GET 


SET SWITCH FOR SECOND GET 
REG6 - PTR I/O INFORMATION 
PTR RECORD TO I/O INFO 

RECORD LENGTH TC [/0O INFO 


SECOND TIME - END OF DATA 


RETURN IF OPEN/CLOSE 


//GO.STEPCAT DD DSN=CSVS.VSAMUCAT,DISP=SHR 
//GO.SYSUDUGME DD SYSOUT=A 


H 1.15 
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ALTERNATE INDEXES 


c 


@ ABILITY TO ACCESS A KSDS BY A KEY OTHER THAN THE PRIME KEY 
EXAMPLE: PAYROLL FILE BY NAME, EMPLOYEE SERIAL NUMBER, OR 
DEPARTMENT NUMBER 


ABILITY TO ACCESS AN ESDS BY KEY 


ABILITY TO INDEX ON A NON-UNIQUE KEY FIELD 


ABILITY TO HAVE MULTIPLE PATHS TO A DATA SET 











H.2.1 
tg 
| 3235 livewron] | 3247 [Avams I kinney| prity ep 
| | ea ALTERNATE INDEX 
| a“ DATA RECORDS 
| 4711 | SIEGEL | PRICE pARNOLD LEE 
Yo 
WRIGHI PRICE KINNEY PRIME INDEX 
Q? an 00 
a” 
| | D dhee | Sy 
aDAmMsw | | 3247 | ARNOLD, 4711 KINNEY ) 4247 - 
| | | mes PRIME 
a DATA 
| pETITYO | 3 Lo] opie | arid | ee BASE 
even, | 3235 | t oe to , Ze 
” 
| | | 
AIN1 wright | | yea , 
H.2.2 
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ALTERNATE INDEX RECORD FORMAT 





























—,, 
FLAG POINTER NUNIBER (OF LENGTH OF | | | } 
| BYTE LENGTH POINTERS ALTERNATE See POINTER } fo oa POINTER N 
«Vo bytes 12 byte | KEY KEY 
(T hytet 
| SAN 
O RBA ponters ; | . oS sg 
‘base clusier «s ESDS! - i 
f x \ Jj 
1+ prime key pointers / i aa 
ibase cluster 1s KSDS! i ? 
- ( ' ae: 
i — 
H.2.3 
Oy 
PATH CONCEPT 
cr @ PATH IS VEHICLE FOR 
ACCESS VIA ALTERNATE KEY 
ALTERNATE INDEX 1 ALTERNATE INDEX 2 @ PATH CONSISTS OF BASE 
FILE-ID=AIX1 FILE-ID=AIX2 CLUSTER AND, OPTIONALLY, 
AN ALTERNATE INDEX 
@® MULTIPLE PATHS FOR SAME 
ALTERNATE INDEX OR 
FOR BASE CLUSTER 
PATH PATH : 
FILE-ID FILE-ID 
AIX1 AIX2 
RELEASE 1 CLUSTER 
data 
FILE-ID=BASE 
sarttan 
H.2.4 


THE UPGRADE SET 


el pene Mecded 


Pt ee 





ALTERNATE INDEX 2 





ALTERNATE INDEX 3 





BASE 
CLUSTER 


UPGRADE SET 





ALTERNATE INDEX 4 


H.2.5 





AUTOMATIC UPGRADE 


FOR MEMBERS OF UPGRADE SET 

IF BASE CLUSTER OPENED DIRECTLY OR VIA UPDATE PATH 

NEW POINTERS ARE ADDED TO END OF POINTER SET OF ALTERNATE 
INDEX RECORD (ARRIVAL-TIME ORDER) 

ALTERNATE KEYS EXCEPT THE KEY OF REFERENCE MAY BE CHANGED 
UPDATES OR INSERTS FAIL JF THEY PRODUCE A NON-UNIQUE KEY FOR A 
UNIQUEKEY MEMBER OF THE UPGRADE SET 


H.2.6 





STEPS FOR LOADING AN ALTERNATE INDEX 


DEFINE THE ALTERNATE INDEX 


EXTRACT ALTERNATE KEYS & POINTERS 


ORDER KEYS & POINTERS BY ALTERNATE KEY SEQUENCE 


BUILD ALTERNATE INDEX RECORDS 


BUILD ALTERNATE INDEX AS A KSDS 


H.2,7 


DEFINING AN ALTERNATE INDEX 
ACCESS METHOD SERVICES 
DEFINE ALTERNATEINDEX 
(RELATE (entryname [/password] ) 
[UPGRADE | NOUPGRADE] 


[UNIQUEKEY | NONUNIQUEKEY] 


[DATA 


( [UNIQUEKEY | NONUNIQUEKEY] 


] 

[INDEX 
® 
@ 


YL ————$—_—_— LT 


LL 


SAME AS FOR KSDS CLUSTER LEVEL, 
BUT YOU CANNOT SPECIFY 

INDEXED, { SPANNED INONSPANNED } . 
KEYS APPLIES TO ALTERNATE KEY. 


SAME AS FOR KSDS DATA LEVEL, 
BUT YOU CANNOT SPECIFY { SPANNED | 
NONSPANNED } . KEYS APPLIES TO 
ALTERNATE KEY. 


SAME AS FOR KSDS INDEX LEVEL 


H.2.8 


DEFINE ALTERNATE INDEX 


DEFINE ALTERNATEINDEX (NAME (DEPT.NUMBER.AIX.PAYROLL) - 


DATA 


INDEX 


RELATE (PAYROLL/MASTERPW) — 
VOLUMES (AIX001 AIX002) — 
UPGRADE) —- 

(NAME (DEPT.NUMBER.DATA) — 
CYLINDERS (5 5) — 
RECORDSIZE (200 4046) — 
KEYS (7 65) — 
NONUNIQUEKEY) — 

(NAME (DEPT.NUMBER.INDEX) — 
IMBED — 

CYLINDERS (2 1)) 


H.2.9 
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DEFINING A PATH 


ACCESS METHOD SERVICES 


DEFINE PATH 


(NAME (name) 

PATHENTRY (entryname[/password] ) 

[MODEL (entryname[/password] 
[catname[/password] [dname] ] )] 

[FILE (dname)] 

[UPDATE | NOUPDATE] 

[protection parameters] 


[CATALOG (catname[/password] [dname] )] 


H.2.10 





ve 


DEFINE PATH 


DEFINE PATH (NAME (DEPT.NUMBER.PATH.PAYROLL) — 
PATHENTRY (DEPT.NUMBER.AIX.PAYROLL) — 


UPDATE) 


H.2.11 


a 


LOADING ALTERNATE INDEXES 


ACCESS METHOD SERVICES 
BLDINDEX INFILE (dname_ [/password] ) 
OUTFILE (dname_ [/password] ...) 
[EXTERNALSORT |! INTERNALSORT] 
[WORKFILES (dname1 dname2)] 
[CATALOG (catname_ [/password] }] 


DEFAULT WORKFILES: IDCUT1 , IDCUT2 


H.2.12 


c 


BLDINDEX 


BLDINDEX 


INFILE (base cluster name/master password) 


OUTFILE 


(alternate index name) - 


WORKFILES (sortwrkl sortwrk2) 


A aed 


H.2.13 
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PROCESSING AN ALTERNATE INDEX AS A KSDS 


were e ete eww ewe ewe eee ee!’ H- ew eee wee ee eke ew BkzxWwey—e— we kee ewe ee Be ew ee ee eB eB eee eee ee ee ee Be ee Be 


ACBe 


//DD2 


OPEN 


ACB 


ACB 


DD 


ACBI 


DDNAME=DD!1 


DSNAME = alternate index naime, 


DDNAMEF: 11) 2, MACRE (AIX Ot 


DSNAME = path name, DISP = SHR 





DISP = SHR 


[eles 


weeeencneecneneneene- ween ec eke ewww ener eee ew er eee eee ewe we eH we ee eee ee ee te ee ee eee 


PROCESSING ON A PATH LEVEL 


ae mee = ee ew ee ee BF he se Fe ee ee EK PF |= w eP~ we ee SK Ow BP Fe |F K— BH ee ee EE SE OE SS OE ES ee ee eel 


OPEN ACBI1 
ACB1 ACB DDNAME=DD1, MACRF=OUT 
DD1 DD DSN= path name, DISP=SHR 


H.2.15 


gee ne 
ACCESSING THROUGH A PATH 


IF PATHENTRY IS ALTERNATE INDEX THEN 
@® KEYED PROCESSING AS FOR KSDS 
@ ALTERNATE KEY ASSOCIATED WITH PATHENTRY 
AIX IS KEY OF REFERENCE 
@ HOWEVER, 
C KEY OF REFERENCE AND PRIME KEY 
CANNOT BE CHANGED 
Q LIMITATIONS IMPOSED BY BASE CLUSTER 
APPLY. 
NO ERASE IF BASE CLUSTER AN ESDS, 
NO UPDATE WITH LENGTH CHANGE IF 
BASE CLUSTER AN ESDS, 
INSERTS GO TO END OF ESDS. 
IF PATHENTRY IS BASE CLUSTER THEN 


@ SAME AS FOR BASE CLUSTER 
H.2.16 


eer 


HANDLING OF NON-UNIQUE KEYS 


i ! 
ALTERNATE INDEX E 3247 AADAMSH PETTY [KINNEY 


RECORD 
Pee 


| i] 
iPRICEB IKINNEY 
t 


I t i 1 I _—— 

A 1 4 | Fa m= 

ADAMS | | 3247 ARNOLD , oy KINNEY 1 132477 a 

BASE CLUSTER eee 
DATA COMPONENT ] aaaz 
NEWTON | L 305A PETTY | 3247 PRICED si! WV we | 

v ig a 


POINT positions to first “‘non-unique” of alternate index record (ADAMS#) 





e GET skip-sequential or direct retrieves first ‘‘non-unique’’ as indicated in 
alternate index record (ADAMS#) 


e GET sequential retrieves ‘“‘non-uniques” in order indicated in alternate 
index record (ADAMSB, PETTYG, KINNEY) 


H.2.17 





ALTERNATE INDEX 
RESTRICTIONS 





@ NO ALTERNATE INDEXES FOR RELATIVE RECORD DATA SETS —‘*- 
@ FOR SPANNED RECORDS, ALL KEYS MUST BE WITHIN FIRST SEGMENT 
@ LENGTH OF ALTERNATE KEYS MUST NOT EXCEED 255 -~- 
—+ @ BASE CLUSTER MUST NOT BE EMPTY FOR BLDINDEX 
\@ UPGRADE DONE ONLY FOR NON-EMPTY ALTERNATE INDEXES 


SUNS, eae CARAT 62 at ee ark 


H.2.18 


Cc 


LOCATING MASTER CATALOG 


VS1 SYSCTLG VS2 SYS1.NUCLEUS 
AMASTCAT CVOL POINTER SYSCATLG RECORD 
4 (VS2) 
Fi DSCB STARTS 2999999 OR 
6 (VS1) 


VSAM INTEGRITY 


F4 DSCB - OWNERSHIP BIT FOR VOLUME OFFSET x’‘54 
F1 DSCB — OS/VS PROTECT BITS ALWAYS ON x‘5D’ 


H.3.1 


H.3.2 


VOLUME CONTAINING A VSAM CATALOG 









fd OSCR 


eal 





9999994 YWSAMDS 


fo C Aetna 





VSAM 
DATS SPACE 


/ a 


\ LOW KEY RANGE VSAM CATALOG 





















































INDEX 
__ HIGH KEY RANGE —_-—” 
H.3.3 
VSAM CATALOG 
INDE DATA AX 
RELI A RIES. Pa Bee 
a eo 
Pa * ™ 
wee oe 
2 Ae INIE x 
we te D. SET 
[xyz J Porronno, | 
KEY (KI 00!” , 
ie *y 
yoy | LOW KEY RANGE 
(Cl ENTRIES) 
f 0 11] ooonfa Peeve 1. | 
| c - LALA 
SRG. lea 
ie i een Dob 
\ \ : 
X'3F 7 = 
BO: | iG Key < 
RANGI 
(TRUE NAME en ae 
ENTRIES) |<—— 4 ) --—_» 
ii H.3.4 
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Self-Defining Catalog Records 


e Located by Pre—Defined Physical Location 


@ Formats Same as Object Definition Records 


e Record Contents 





CI@— Data Portion Descriptor 

Cli — Index Portion Descriptor 

Cl2— Cluster Descriptor 

Cl3— Catalog Control Record — Cl Allocation Data 
Cl4— Extension of Cl 1 — High Level Index Extents 
Cl5— ~~ Extension of Cl @ — Low Address Data Extents 
Cli6— Extension of Cl 1 — Low Address Sequence Set 
Cl7— Extension of Cl @ — High Address Data Extents 
ClI8— Extension of Cl 1 — High Address Sequence Set 
CI9— This Volume Space Allocation Descriptor 
CiIA—_— Extension of Cl 9 — This Volume’s Bit Map 
Cip-— Extension of Cl 9 — As Many as Required 























H 3.5 
LOW KEY RANGE RECORD FORMAT 
aera FIXED INFORMATION 
DEPEND ON RECORD TYPE 
CRA INFO 
0 1 4 43044 45 46 47 48 40 
Cc 
0 
HORIZ U |FIELDO] FIELD FIELD FIELDS 
PTR nw |PTRS PTRS PTRS 
T te 
! av 
ail Peat VERTICAL 
POINTER en 
00 OIsP |CODE|SEQ= Cl= CODE 
o 1 2 3 4 Oo 2 3 
CODES 1 AMDSB 4 TRACK ALLOCATION 
2 ~ ASSOCIATION 6 DATA SPACE {tNFO 
3 - VOLUME INFO 8B —- DATA SET DIRECTORY er 


4 - PASSWORD 








CATALOG STORAGE ESTIMATE WORKSHEET 


NUMBER OF ENTRIES FOR CATALOG 


NUMBER OF ENTRIES REQUIRED FOR LOW KEY 
RANGE (SEE TABLE) 


O+® 
NUMBER OF CIS FOR HIGH KEY RANGE 


@ 


‘10 (ROUND HIGH) 


TOTAL 


TOTAL NUMBER OF CIS REQUIRED 

QO: @ 
NUMBER OF TRACKS REQUIRED FOR DATA 
(ROUND HIGH) 6) 


NO. OF Cls/TRACK* 


"11 FOR 2314, 20 FOR 3330, 12 FOR 3340, 27 FOR 3350 


NUMBER OF TRACKS FOR IMBED SEQUENCE SET 
(ROUND HIGH) © 


Nn" 


“"4 FOR 2314, 2 FOR 3330, 4 FOR 3340, 2 FOR 3350 


TOTAL NUMBER OF TRACKS FOR DATA AND 
SEQUENCE SET. 


©: @ 


ROUND UP TO MULTIPLE OF CA SIZE n 


n IS 5 FOR 2314, 3 FOR 3330, 5 FOR 3340, 3 FOR 3350 


NUMBER OF TRACKS FOR INDEX SET 


TOTAL NUMBER OF TRACKS FOR 
DATA AND INDEX SET (9) | 


2314 3330 3350 








—- 





G2 
on 
GJ 


RNR ee a ae ~ = 


CATALOG STORAGE 


LINE 2 OF WORKSHEET 
NUMBER OF ENTRIES REQUIRED FOR LOW KEY RANGE: 


NUMBER OF 
KSDS X 3 = 
ESDS X2 = 
RRDS X 2 = 
PATHS X 1 = 
AIX X3= 
UPGRADE X 1 = 
NON-VSAM X 1 = 
VOL X (3+n)* = 


a 


TOTAL NUMBER OF ENTRIES = 
(LINE 2) 


"n=0 FOR 2314/2319 
n=1 FOR 3330/3340 
n=3 FOR 3350/3330-11 


H.3.8 
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CATALOG RECOVERY 


@ ABILITY TO DUPLICATE CATALOG INFORMATION AT DECENTRALIZED 
PLACES 


®@ A SET OF ACCESS METHOD SERVICES COMMANDS EASING THE 
RECOVERY FROM THE LOSS OF CATALOG INFORMATION 


H.3.9 
















CATALOG RECOVERY 


Omg — = 
ENTRY CATALOG 
ENTRY emg | — — — 7 
t ) 
j ENTRY \ Nee 
—, 
— 
REA a ee 


RECOVERABLE CATALOGS 





CA EA 
TALOG RECOVERY AR 














H.3.10 
VOLUME CRA WHICH WILL CONTAIN THE 
DUPLICATE CATALOG RECORDS 
ee INDEX 7 CLUSTER \ MASTER CATALOG USER CATALOG 
ener, VOLUME bom vom OWNING NONE MASTER CATALOG 
OF BASE CLUSTER VOLUME OF SPACE VOLUME 
BASE CLUSTER 
Ken -U SAV 
Dae i pum s+! KSDS ESDS RRDS 
oc Poe cag aa is f es “ ip me 
. 8 a FIRST INDEX FIRST DATA FIRST DATA 
Re Se VOLUME VOLUME VOLUME 
4.3.11 





CATALOG RECOVERY AREA (CRA) 


DUPLICATED VOLUME RECORD 
@ SPACE USAGE MAP 
® DATA SPACE DESCRIPTION 
@ DATA SET DIRECTORY 


DUPLICATED CATALOG RECORDS FOR 
OBJECTS FOR WHICH THIS VOLUME 
IS THE RECOVERY VOLUME 








ESTABLISHING A CATALOG RECOVERY AREA 


e THE CATALOG RECOVERY AREA FOR A VOLUME IS 
ESTABLISHED AT THE TIME THE VOLUME ENTRY FOR 
THE VOLUME IS CREATED, I.E., WHEN THE VOLUME 
APPEARS FOR THE FIRST TIME IN THE VOLUMES OR 
ADDVOLUMES LIST OF AN ACCESS METHOD SERVICES 
COMMAND 

© ONE CYLINDER OF THE FIRST SPACE ALLOCATION FOR 
A VOLUME IS SET ASIDE FOR THE CATALOG RECOVERY 


AREA 


et pr ae “2 Le ‘e 
j t s tH1313 


MOUNTING REQUIREMENTS WITH RECOVERABLE CATALOGS 






ACTION 





DEFINE 


ALTER ALL VOLUMES OF EVENTUAL ADDVOLUMES 
OR REMOVEVOLUMES LISTS, RECOVERY 
VOLUME OF OBJECT BEING ALTERED 

DELETE ALL VOLUMES OF OBJECT BEING DELETED, 
RECOVERY VOLUME OF OBJECT BEING 
DELETED 

BLDINDEX, ALL VOLUMES REQUIRED FOR NON- 

EXPORT, 

IMPORT. PRINT RECOVERABLE CATALOG, RECOVERY 

REPRO, VERIFY VOLUMES OF OBJECTS BEING PROCESSED 

LISTCAT SAME AS FOR NON-RECOVERABLE CATALOG 

VSAM ALL VOLUMES REQUIRED FOR NON- 

PROGRAM 





VOLUME MOUNT REQUIREMENTS 






ALL VOLUMES OF AN EVENTUAL VOLUMES 





LIST, RECOVERY VOLUME OF OBJECT 
BEING DEFINED 








RECOVERABLE CATALOG, RECOVERY 


VOLUMES OF OBJECTS BEING PROCESSED H3.14 





Catalog Interfaces 


VSAM 
AMS OP|CL IT EOV 















“Detine™ 
“Alter” 

“pete 
“List 






OS/VS 
Scheduler 
“Locate” 














OS/VS SVC 26 
Catalog Management 









R15 Error Code 


SVC 32 






Error DADSM 


Messages 






SVC 32 





VSAM 
Catalog 
Management 


Extend 







Scratch 


Rename 


Cavsiog 


H 3.15 





FOUR LEVELS OF PROTECTION 


MASTER LEVEL 
CONTROL LEVEL 
UPDATE LEVEL 


READ LEVEL 


ENTRY HIERARCHY 


CLUSTER — HIGHEST LEVEL 


DATA/INDEX — SAME LEVEL 





ONLY READ LEVEL PASSWORD SPECIFIED 


READPW(ALLOW)}) 


RESULTS IN: 
MASTER PASSWORD ALLOW 
CONTROL PASSWORD ALLOW 
UPDATE PASSWORD ALLOW 
READ PASSWORD ALLOW 


READ AND CONTROL PASSWORD SPECIFIED 


READPW(ALLOW) 
CONTROLPW(ALLOWIT) 


RESULTS: 
MASTER PASSWORD ALLOWIT 
CONTROL PASSWORD ALLOWIT 
UPDATE PASSWORD not specified 


READ PASSWORD ALLOW 


11.4.4 


C 


AUTHORIZATION PARAMETER 


AUTHORIZATION (ENTRYPOINT STRING) 


ENTRYPOINT IS THE ENTRY POINT OF YOUR ROUTINE ON 
SYS1.LINKLIB. STRING IS YOUR OWN SECURITY INFORMA- 


TION UP TO 256 BYTES 


ABBR. AUTH (ENTRYPOINT STRING) 
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PASSWORD PROTECTION EXAMPLE 1 


CATALOG PROTECTED AT THE MASTER LEVEL 
DEFINE CLUSTER (NAME(FILE1) 
MRPW(CM04) - 
CTLPW(CCO3) - 
UPDPW(CUO2) - 
RDPW(CRO1)- - 

DATA NAME (DATA!) - 
MRPW(DMO04) - 
CTLPW(DCO03) 
UPDPW(DU02) - 
RDPW(DRO1) - 

INDEX (NAME(INDEX1) 
MRPW(IMO4) - 

CTLPW (ICO3) - 
UPDPW(IU02) - 
RDPW(IRO1)}) 

WHICH PASSWORD (5) IS/ARE REQUERED FOR THE POECOWING 
a. TO UPDATE THE INDEX COMPONENT ? 
b TO UPDATE THE DATA COMPONENT ? 
c. TO UPDATE THE DATA SET (FILE1) ? 
d TO DELETE THE DATA SET (FILE1) ’ 


10 e ntaes ane mesmnaseesnmeamnegeneteeeneeeeneenenne eine 


PASSWORD PROTECTION EXAMPLE 2 


DEFINE CLUSTER (NAME(FILE2) 
MR PW (null) 
CTLPW(null) 
UPDPW(null)  - 
RDPW(null) 
DATA NAME(DATA2) 
MRPW(D2M04) 
CT LPW(D2C03) 
UPDPW(D2U02} 
RDPW(D2R01) - 
INDEX (NAME(INDEX2) - 
MRPW(12M04) 
CT LPW(12C03) 
UPDPW(I2U02) 
RDPW(I2R01) ) 
WHICH PASSWORD (S) IS/ARE REQUIRED TO DO THE FOLLOWING 
a, UPDATE THE DATA COMPONENT (DATA2) ? 
b. READ THE INDEX COMPONENT (INDEX2) ? 
C, READ THE DATA SET (FILE2) 
d. DELETE THE DATA SET (FILE2) 
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VSAM INTEGRITY 


CONTROL INFORMATION SECURITY 
Uoe OF FREE. SPACE 

INDEX UPDATED ONLY ON SPLIT 
SPLIT SEQUENCE CONTROL 
SOFTWARE EOF 

WRITE CHECK OPTION 


CONTROL INTERVAL SPLIT SEQUENCE 


l. TARGET Cl IS DIVIDED INTO TWO 
Cl's IN PRIMARY STORAGE 

2. RECORD TO BE INSERTED IS PLACED 
IN THE PROPER Cl IN PRIMARY 
STORAGE 

3, NEW Cl IS WRITTEN TO A SPARE Cl 
IN THE GIVEN CA ON SECONDARY 
STORAGE 

4. SEQUENCE SET RECORD IS UPDATED IN 


PRIMARY STORAGE AND WRITTEN TO 
SECONDARY STORAGE 

>. UPDATED TARGET CI IS WRITTEN TO 
SECONDARY STORAGE 





SMF RECORDS AND VSAM 


TYPE 68 — VSAM ENTRY RENAMED 

TYPE 63 — VSAM ENTRY DEFINED 

TYPE 67 — VSAM ENTRY DELETED 

TYPE 69 — DATA SPACE DEFINED, DELETED 
OR EXTENDED 

TYPE 64 -— DATA SET CLOSED OR EOV 

TYPE 62 —- DATA SET OPENED 





DATA & INDEX UPDATE (AMDSB) TIMESTAMP 


ea \ 


CATALO TU sone 


(I: 


fo 
| 
Pee 


ue DAY J 


TO CORRECT: VERIFY 
OR 
UNLOAD, SORT, RELOAD 


1.5 4 


< me 
Pe 


wh, 
f= 


Cc DATA & INDEX CREATION TIMESTAMP 


saa 

| VOLOO1 CREATED 
ae 
- 


| VOLOO2 CREATED 


a 


oa \ 


| 0 ha | 
l CREATED ‘ 
| | 12/1 | 
XQ 
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VOLUME TIMESTAMPS 


f fa. ‘\ 
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BACKUP / RECOVERY CONSIDERATIONS 


@ NECESSITY FOR BACKUP 


@ BACKUP 
FREQUENCY 
- TIME REQUIRED 
- EASE 


@ RECOVERY 
- POSSIBLE FREQUENCY 
- TIME REQUIRED 


- EASE 
@ SECURITY 
e  =INTEGRITY 
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TYPES OF RECOVERY 


REPAIR 
RESTORES ADDRESSABILITY AND ACCESS TO 
THE CURRENT VERSION OF THE DATA 


RESET 
RESTORES ADDRESSABILITY AND ACCESS TO A 
PREVIOUS VERSION OF THE DATA 





RECOVERY TOOLS 


NON-RECOVERABLE CATALOGS 
EXPORT/IMPORT 
REPRO 
IEHDASDR 
VERIFY 

RECOVERABLE CATALOGS—ADDITIONAL TOOLS 
EXPORT RA/IMPORTRA 
LISTCRA (COMPARE) 
ALTER (REMOVE VOLUMES) 
DELETE (FORCE) 
RESETCAT 


RESET 
RESET/REPAIR 
RESET 
REPAIR 


RESET/REPAIR 
ANALYSIS 
RESET/REPAIR 
RESET/REPAIR 
REPAIR 
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a a EI ET TE TS TE a 
RECOVERY FACILITIES FOR VSAM 


ACCESS METHOD SERVICES 


REPRO 
EXPORT/IMPORT 
VERIFY 
EXPORTRA/IMPORTRA 
LISTCRA 

RESETCAT 


USER PROGRAM - JOURNAL 
SMF 
IEHDASDR 
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BACKUP / RECOVERY ALTERNATIVES 


e SPIN-OFF DATA SETS 


e USER WRITTEN PROGRAMS 


@ REPRO 


e@ EXPORT / IMPORT 


e JEHDASDR 
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VSAM VOLUMES 


° A GIVEN VOLUME CAN BE OWNED BY 
ONE AND ONLY ONE CATALOG 


e OWNERSHIP INDICATED WHEN SPACE OR 
CANDIDATE VOLUME DEFINED 
FORMAT 4 FLAG 
CATALOG VOLUME RECORD 


e RETURN OF VSAM VOLUMES 


DELETE DATA 


DELETE SPACE 


Wh Ve 


PROBLEMS REQUIRING RECOVERY 


DATA SET NOT PROPERLY CLOSED 
@ INCORRECT HIGH RBA IN CATALOG 
e@ INCOMPLETE WRITE TO DASD 
e DUPLICATE DATA 


DATA SET INACCESSIBLE 
@ DATA SET CANNOT BE OPENed 
@ DATA SET COMPLETELY UNREADABLE 
@ DATA SET PARTIALLY UNREADABLE 


UNUSABLE CATALOG 
@ MANY VSAM DATA SETS CANNOT BE OPENed 
@ THE CATALOG CANNOT BE OPENed 
e@ THE CATALOG VOLUME IS NOT USABLE 
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COPY A CATALOG (MVS ONLY) 
: hy. ‘ b ee, s, Pots te ‘ 
> . one fo Waws ys tucloce ) 
BEFORE COPYCAT 





| VOL1 
| 
| SOURCE CAT 
| (Vv) VOL1 
) (V) VOLS 
es Fane a ee 
AFTER COPYCAT 
eer — aa lamas ces PEE NES = 
VOL1 VOLS VOLT 






TARGET CAT 
(V) VOLT 
(V) VOLS 


(V) VOL1 4 
Source C& 













SOURCE CAT 
(V) VOLS 
(Vv) VOL1 
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ae i ¥ woe yb S a rs ,e oy . 
ae }: L * 1 Ce uy aN “. ! fe orw foe iy bos 
ae : 


Sow 


CATALOG RECOVERY AREA FUNCTIONS: «Si? S = 
ACCESS METHOD SERVICES ) 


LISTCRA. LISTS CRA OBJECTS 
DUMPS CRA RECORDS 
COMPARES CRA WITH CATALOG 


RESETCA: COMPARES CRA AND CATALOG 
REBUILDS CATALOG FROM CRA 


EXPORTRA EXPORTS FILES USING CRA 
MULTIPLE FILES ON SINGLE MEDIUM 


IMPORTRA IMPORTS FILES FROM COPY 
CREATED BY EXPORTRA 


c H.5.15 seat 


CRA RECORD RELATIONSHIP oy [s. © gc cee t ect él 7 
‘ 5 Ge . et . ne . 
CATALOG CRA pf. 
. ur 5S 
| re cand oe en ad 
ad mets) (C) | cra}ioo [pfreo [ | AQO POTS oat - Se 
a 100 “aes 
10] r ( 





‘ 160 


Cl 
400 





THE ASSOCIATION THAT IS IN THE CATALOG IS NOT IN THE CRA 


: PHEREL ARLE NO POINTE RS JOINING Cl’s 100,101 AND 250 IN THE CRA 


Hoy Ih 





Cc 


COMPARING OR LISTING THE CRA 


LISTCRA COMMAND 
@ WITHOUT COMPARE OPTION 
LISTS NAME, TYPE, AND VOLUMES OF ALL OBJECTS 
“DEFINED” IN THE SPECIFIED CRA, OR 
— PRINTS ALL CRA RECORDS IN DUMP FORMAT 
@ WITH COMPARE OPTION 
— COMPARES CRA RECORDS WITH APPROPRIATE RECORDS 
OF A SPECIFIED CATALOG 
— LISTS OR DUMPS ALL NON-MATCHING CRA ENTRIES AND 
THEIR EQUIVALENT IN THE SPECIFIED CATALOG 
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LISTCRA DUMP COMPARE 


THE CRA RECORD IS ALWAYS USED AS 
THE BASE FOR COMPARISON 


EXAMPLE 1 


aa a a ae 
crarco | |..[t}s|tig|............ |DspiR1 |DSDIR2 | 





“MISCOMPARE DATASET DIRECTORY’ WILL ALWAYS BE 
ISSUED BECAUSE DSDIR2 COMPARES INCORRECTLY. 


EXAMPLE 2 


END OF S 


coanco [Te] dso 


carneo [T [re]rep soins [sore 
PN ee ee 


THE MESSAGE ISSUED MAY BE “OTHER BFCAUSF 
THE DATASET DIRECTORY FIELD COMPARLS CORRECILY, 





OF 
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LISTCRA WITH COMPARE OPTION 


LISTCRA INFILE (CRA1 CRA2) — 


COMPARE —- 

NAME — 

MASTERPW(MSTPW) — 

CATALOG (USER.CATALOG/UMSTPW UCAT) 
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EXPORTING DATA BASED ON THE CRA 


EXPORTRA COMMAND 


USED TO RECOVER VSAM CATALOG ENTRIES AND DATA 
BY MEANS OF THE CATALOG RECOVERY AREA 
INFORMATION RECOVERED IS RECORDED ON A PORTABLE 
MEDIUM, MULTIPLE DATA SETS ON SINGLE PORTABLE 
MEDIUM 

SPECIFIABLE OBJECTS. ALTERNATE INDEXES, CLUSTERS, 
USER CATALOGS. NONVSAM 

PATHS ARE AUTOMATICALLY EXPORTED WITH PATH 
ENTRY CLUSTER 

REFCOVFRY VOLUMF MUST BE MOUNTED 


H 5.20 


EXPORT BY MEANS OF CRA 


//STEP 1 EXEC PGM=TDCAMS 


//DD2 DD UNIT=(3330,2) ,AMP='AMORG' , DISP=OLD, VOL=SER= ( : 

’ = = = (VOLO2 , VOLO 3 
//DCRA1 DD UNIT=3330,VOL=SER=VOL01,AMP=' AMORG' 
7 /DCRA2 DD UNIT=3330,VOL=SER=VOL02,AMP='AMORG' 


//DCRA3 DD UNIT=3330,VOL=SER=VOL03, AMP='AMORG' 
//OUTFILE DD UNIT=2400,VOL=SER=TAPE1 ,DSN=BACKUP 
//SYSPRINT DD SYSOUT=A 
//SYSIN DD * 
EXPORTRA CRA ( ( DCRA1 ENTRIES ((VSAM.CLUSTER ) ) ) - 
( DCRA2 ALL INFILE (DD2 ) } - 
( DCRA3 NONE ) ) - 
OUTFILE (OUTFILE) - 
MASTERPW (MASTER) 
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SS eS SDSS SSS SSS Sa SSS 
IMPORTING DATA RECOVERED BY EXPORTRA 


IMPORTRA COMMAND 
@ USED TO IMPORT OBJECTS ON A PORTABLE MEDIUM CREATED 
BY EXPORTRA 
@® AUTOMATIC DEFINITION OF OBJECTS ON PORTABLE MEDIUM 
@ ALREADY EXISTING OBJECTS ARE AUTOMATICALLY REPLACED 
BY OBJECTS ON PORTABLE MEDIUM 
@e RECOVERY VOLUME MUST BE MOUNTED 
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IMPORTRA EXAMPLE 


//1MP EXEC PGM=IDCAMS 
//INDD DD DSN -EXPORTRA.DATASETS, VOL :SER TAPE], ... 
//OUTDD DD DSN-ANYNAME.NOTIN,DISP OLD, 


// VOL SER-(VOLTIT,VOL222 VOL333) UNITE 3330, 
if AMP='AMORG’ 
/ISYSPRINT DD SYSOUT=A 
/ISYSIN DD * 
IMPORTRA INFILE (INDD) — 
OUTFILE (QUTDD) 





RESETCAT FILES 


A. CAT-10O-BE~RESET WORKFILE WORKCAT 


os. VSAM OWNED 
ahve ape Gost he 5! USERCAT 


Pat 





B. CAI TO BE RESET WORKFILE WORKCAT 
OWNED 
DEVPIACAT Tene Sy 


mN 


F Be 
Sk 
| CRA es 
Bice <a. Oe eae 
C. CAT Tu BE RESET WORKKE ILE WORKCA 
3 VSAM 
DEPTACAT | = RROS es 
fy” 4 ®S 
Ss ps 


| | ; H 5.24 
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RESETCAT LOGIC 


SIMPLIFIED REPLACE/INSERT/DELETE LOGIC 


ENTRY IN CRA Y 


ENTRY IN CATALOG Y 














REPLACE 
ENTRY 
IN 
| CATALOG 








INSERT 
ENTRY 
IN 
CATALOG 









DELETE 
ENTRY 
IN 
CATALOG 








ASSOCIATION CHECK 


— MANY RECORDS IN THE VSAM CATAIOG CONTAINS Cl 
NUMBERS TO OTHER CATALOG RECORDS. 


— FOR EXAMPLE 





VOLUME 





EXTENSION 


— ALL Cl#s IN THE RECORDS ARE CHECKED FOR CORRECT 
ASSOCIATION. 
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DATA SPACE ACCOUNTING 


sc al 


| VOLUME RECORD | 
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SPACE CONSISTENCY CHECK 


e FROM VOLUME RECORD SPACE HEADER BUILD A BIT MAP 





e FOR EVERY TRACK OCCUPIED BY ‘DSA’ ZERO OUT 
CORRESPONDING BIT 


110000 1 





‘DSA’ 


¢ DO THE SAME FOR ‘DSB’ 


‘DSA’ 


INDICATES SPACE CLAIM 
IN CONFLICT 





‘DSB’ 


e ‘DSB’ WILL BE MARKED USUSABLE, 8 TRACKS FREED UP 





FREED UP H.5.28 





cC RENAME EXAMPLE 


“ 


CATVOL ABCVOL 


BEFORE = | c DS.xYZz| ae 
RESET: 
A DS.XYZ 


CRa 
AFTER A | DS.XYZ | 
RESET: 


G.N.=TXXXXXXX.VSAMDSET.DFDYYDDD.TYYYYYYY H.5.29 








PROCEDURES TO TAKE BEFORE RESETCAT 


LISTCAT ALL ON THE CATALOG TO BE RESET. 
LISTVTOC ON ALL THE VOLUMES TO BE USED IN RESET. 


LISTCRA COMPARE DUMP SHOULD ALSO BE “TAKEN. 
(OPTIONALLY, PRINT THE CATALOG AND LISTCRA 
SDUMP). 


THE CATALOG OR THE CATALOG VOLUME SHOULD BE 
BACKED UP. 


THE VOLUMES TO BE USED FOR RESET SHOULD BE 
DUMPED. 


S H.5.30 


PROCEDURES TO TAKE AFTER RESETCAT 


EXAMINE THE MESSAGES! 
LISTCAT ALL 
LISTCRA COMPARE ON THE RESET VOLUMES 
DATASETS MARKED NOTUSABLE? 
DELETE 
ENTRIES RENAMED? 
ALTER 
CHANGE JCL OF PROCESSING PROGRAMS 
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RESETCAT COMMAND 


RESETCAT CATALOG ( CATNAME [DNAME] ) 
CRAVOLUMES ((VOIL3ER [DEVTYPE] )(... .. Jf 
CRAFILES ((ONAME { ALL | NONE} ).. . 21) 
[WORKFILE (ONAME):! 
[WORKCAT (CATNAME)] 
[MASTERPW (PASSWORD)| 
[IGNORE | NOIGNORE] 
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; + 
{ RESETCAT EXAMPLE 1 
//RESTOR EXEC PGM-:IBCAMS 
aia //STEPCAT DD DSN USERCAT,DISP=SHR 
re: DD DSN DEPTACAT, DISP -OLD 
//DONAME D0 DSN DEPTACAT,DISP OLD 
//\WF DD UNIT 3330, VOL SER-MV00/5,DISP -OLD,AMP AMOKG 
//VOL1 DD UNIT=3330, VOL=SER=VOLO01,DISP=OLD,AMP=AMORG 
//VOL2 DD UNIT=3330, VOL=SER=VOLO002,DISP=OLD AMP=AMORG 
//SYSPRINT DD SYSOUT=A 
/ISYSIN DD a 
RESETCAT CATALOG (NDEPTACAT DNAME) + 
WORKCAT (USERCAT) WORKEILE (WE) + 
CRAFILES ( (VOLI ALL) + 
(VOL2 ALL ) ) 
H 5.33 
ad ‘ 
>. tnt, ( ; WHICH VOLUMES FOR RESETCAT? 
i , pees ee eee ; 
‘ # a f a tf 
MV0102 MV0103 ~~ Cats a 
. cd 
cee % 
a 
PH.KR 
DATA 
| { 
es N 
MISCOMPARE! ‘ 
/ CPi ‘ 
_s* fig 
& FPR ald if 
Le, ee L ols ye 





2 r i z 
ty oy ‘ i eg oer na ; i ; me F . 
— wa / ay ~ y i ; iy ‘ 5 ¢ a } \ % ! & & a ¥ fo / oy ? 
d “ . 4 A va a4 tr if t 7g 
d 
¢ e f } , * 
‘ f : ral 2 rome 
‘ eae 
/ } ec e a t Cs a prea : » 
/ . » fa : 
g ») ww. (te < . “rey Le C 
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BEFORE RESETCAT: 


PHCAT 
NONVSAM IN e 
CRA OF CATALOG 
VOLUME 
CRA 
AFTER RESETCAT 





FORCED RELEASE OF VOLUME OWNERSHIP 


RESETTING INTO A NEWLY DEFINED CATALOG ™%. 








CRA 


@ DELETE FORCE | uc re. 


(A)NVSAMX,VOL1 
(AJNVSAMX,VOL1 


(A)NVSAMX,VOL1 


CATVOL ot sa > 





a ay eer 
CATVOL NEWVOL I 


Amante 


DATA SPACE PHCAT 


CRA 
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t 
i 


aa 


—~ SCRATCHES AND RETURNS NON-EMPTY VSAM DATA SPACES 
TO VTOC 


— RELEASES VOLUME OWNERSHIP 


— MARKS ALL CATALOG ENTRIES FOR VSAM DATA SETS OF 


RELEASED VOLUME AS UNUSABLE, ENTRIES ARE NOT DELETED 


r 
7 
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Cc 


) 
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ACTIONS WHICH CAUSE MISMATCHES 
FROM A BACKUP CATALOG 


DEFINE / DELETE / EXTEND DATA SPACE 
- VOLUME ENTRY IN BACKUP CATALOG NO 
LONGER VALID 


DEFINE / DELETE DATA SETS 
- VOLUME ENTRY IN BACKUP CATALOG NO 
LONGER VALID 


- DATA SET ENTRIES (SOME) IN BACKUP 
CATALOG NO LONGER VALID 


DATA SET EXTEND VIA SUBALLOCATION 
- VOLUME SPACE MAP IN BACKUP CATALOG 


NO LONGER VALID 


- DATA SET ENTRY (ONE) IN BACKUP CATALOG 
NO LONGER VALID 
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H.5.50 


CONTROL INTERVAL FORMAT 


rn Interval a 


Free 
“tal “FiB) TMC) | ER(D) | Spaces) 
Logical ony . System 
Control Information 


* Since logical records LR icy and LRip) are of 





CIDF (ey 
(Free Space) 





equal length, RDF ic) and (D) tells the system 
that LR ip) is the same size as L Ric). 


H.6.1 





Control Interval Definition Field 
(CIDF) 


[fe PO} ik Fs | 


DD FS 2 Bytes: Offset from the beginning of the 
control interval to the free space 
areas. 


LL FS 2 Bytes: Specifies the length of the free 
space area within the control 
interval. ae 





RECORD DEFINITION FIELD (RDF) 


pe] ow | 


R 1 BYTE; CONTROL INDICATORS 


BIT POSITION 


2-3 


INDICATION 
RESERVED (SET TO O). 


NO ADDITIONAL CONTROL 
INFORMATION RELATED TO THIS 
RDF FOLLOWS. 


ADDITIONAL CONTROL INFORMATION 
RELATED TO THIS RDF FOLLOWS. 


NOT SPANNED RECORD 


FIRST SEGMENT 
LAST SEGMENT 


INTERMEDIATE SEGMENT 
SINGLE-RECORD DESCRIPTOR. 
REPLICATION COUNT DESCRIPTOR. 
SLOT CONTAINS RECORD-RRDS 
SLOT EMPTY-RRDS 

RESERVED 





LL 2 BYTES; LENGTH OR COUNT 


el 


ACB 
RPL 


ACCESSING A CONTROL INTERVAL 


MACRF=(CNYV.... 
OPTCD=(CNV.... 


— WITH USER BUFFER MANAGEMENT 


ACB 
RPL 


MACRF=(CNV,UBF.,... 
OPTCD=(CNV,MVE,...), AREA=BUF 


— WITH “IMPROVED” Cl PROCESSING 


ACB 
RPL 


MACRF=(CNV,UBF,ICI.... 
OPTCD=(CNV, MVE...) AREA=BUF 


— WITH FIXED CONTROL BLOCKS 


ACB 
RPL 


MACRE =(CNV,UBF,ICI,CFX.... 
OPTCD=(CNV,MVE.,,...), AREA=BUF 


H.6.3 


H.6.4 





INDEX RECORD GENERAL FORMAT 


FREE UNUSED 
HEADER CI’S SPACE 


INDEX INDEX INDEX 
ENTRIES ENTRIES ENTRIES 


DISPLACEMENT 
FROM SECTION 
TO SECTION 






H.7.1 





LENGTH OF 
POINTER IS 
IN HEADER 


ee 
(v) (1) (1) (1-3) 
K 
i L Pointer 


\¢—_-____—_- Index Entry -__—_—+_—_—}| 








/ ' , 
(> any as Lo a io aia 2 aia a ae aie O = aca ee ee tem | ge et aay 
rx ry { , . 4 : 


NOISSSYdWOO 
Ada IWWHON = 22 


Q3Y¥O0L1S AAA HLONAT = AA 


Q4SS3IYdWOD LNOYS 
— AAA TINA = XX 


LN3W93S 1SV1 5 
QYO03Y GINNVdS 


INASW9SAS GNOODAS = GYO9D3Y GANNVdS C19 





INSW9AS 1SY¥l43) GQYO9AY GANNVdS LID 


010 | AA | zz 119 |oo }xx |z10 | 00 [xx lpiol aa | zz a a 
A “ 3 
a ey ed os a eo ee eo ee J] ™ 


SSIYLNA XJONI GHYO93Y GANNVdS 
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I/O CONTROL BLOCKS 


TIOT 


XS FL I 


ACB 
|_| replaces 
DEBS 


CLUSTER 









CLUSTER CONTROL BLOCKS 


RPL 


DESCRIBE 
ACB 


REQUEST 





1 AMBL 


DESCRIBE 
DATA 
SET 





CHANNEL 
PROGRAMS 


| READ | 
FORMAT 
WRITE 


UPDATE 





lIOBS 


DATA 
INDEX 







WRITE 





H.8.1 
AMBL AMB-DATA 
t DATA AMB 
f INDEX AMB 2a 
AMB-INDEX 
Ci# IN CAT 
H.8.2 


COMPONENT CONTROL BLOCKS 


































AMB 
EDB 
t EDB 
RBAs 
EXTENTS 
t LPMB CCWs 
BUFC CPA 
+ CPA 
t BUFFER BUFFER 
in [ 
t PLH + BUFC 
7< 
ap 
| PLH \ 
H.8.3 
PLACEHOLDERS & BUFFERS aoe 
PLH BUFC INDEX BUFFER 
— [sd 
BUFFER pak 
t CPA CH PG 
+ BUFFER 
SEEK AD 
PLH 


a PLH 


t PLH 





BUFC DATA BUFFER 


CH PROG 


CPA 
meas 





H.8.4 





Cc 


SHARED RESOURCES 


@ SHARE CONTROL BLOCKS & BUFFERS 

e REDUCED STORAGE REQUIREMENTS 

e DEFERRED WRITES 

@ RELATE I/O OPERATIONS 

e FOR RANDOM OPERATIONS 

@ USER CODE OR PACKAGE 

@ LOCAL SHARED RESOURCES (LSR) 

e MVS ONLY: GLOBAL SHARED RESOURCES (GSR) 


ere er PEE tS SS 


BUILD & USE THE RESOURCE POOL 


BLDVRP BUFFERS=(512(5),1024(B),4096(5)), 
STRNO=10,KEYLEN=12 


CUST ACB MACRF=(LSR,DFR,. ..),.-- 


H.8.5 


H.8.6 








BUFFER POOL EXAMPLE 


512 SUBPOOL 
1024 SUBPOOL 


4096 SUBPOOL 





H.8,7 
WRTBFR MACRO 
WRTBFR- RPL=any,TYPE=ALL 
WRTBFR- RPL=name,TYPE=LRU(50) 
WRTBFR RPL=name,TYPE=TRN 
WRTBFR RPL=name,TYPE=DS 
H.8.8 


THE “DISP’” PARAMETER 


//MYDATA DD DSNAME=MY.VSAM.CLUSTER,DISP=OLD 


exclusive enq for dsname 


//OTHER DD DSNAME=MY.OTHER.CLUSTER,DISP=SHR 





check shareoptions 


VSAM SHAREOPTIONS 


e PROVIDE DATA INTEGRITY WHILE SHARING FILES 


e@ SPECIFY AMOUNT OF SHARING: 


— ACROSS REGIONS 


DEFINE SHR (1, 3) 


— ACROSS SYSTEMS 


H.9.1 





H.9.2 





a 
w ala 


SHARE OPTION 1 
ALTERNATE INDEXES 


UPGRADE SET 


OPEN OUTPUT 


PATH 1 
(UPDATE) 





BASE 


CLUSTER 


H.9.3 





SHAREOPTION 2 
WRITE INTEGRITY 


— OPEN FOR SEVERAL INPUTS AND ONE OUTPUT 


H.9.4 


SHAREOPTION 2 


ERROR= 





OUTACB ACB 


OPEN ACBNAME 







ACBNAME 





ACs ...IN, 


OPEN ACB1 






ACBI1 ACB ,, 





VIRTUAL STORAGE 


H.9.5 


SHAREOPTION 3 
NO INTEGRITY 


PROCESSING FOR 
~ SEVERAL INPUTS AND SEVERAL OUTPUTS 


VSAM DOES NOT MONITOR THE ACCESSING TO 
ENSURE DATA INTEGRITY 


H.9.6 


SHAREOPTION 4 — NO INTEGRITY 
BUT HELP FROM VSAM 


@ SEVERAL INPUTS AND SEVERAL OUTPUTS 
@ LIMITED AID FROM VSAM =~» 4. 2... ' tie we MOT a 
@® RESTRICTION ON PROCESSING . 

@ USER RESPONSIBILITY FOR INTEGRITY 


ae 


SHARING WITHIN A REGION 
FULL INTEGRITY 


@® MULTIPLE STRINGS: ACB STRNO=# 

@ REQUEST FAILS IF 
Cl ALREADY HELD BY OTHER STRING 
Cl OR CA SPLIT IN PROGRESS 


C HOY 


eae een tere eneetdieineneneneeenenmeneel 


SHARING ACROSS SYSTEMS 


SYSTEM SYSTEM 
A B 


VSAM 


DEFINE SHR (X, 3) 
or 
SHR (X, 4) 


H.9.9 





SHARING A CATALOG WITHIN A SYSTEM 


a @ TOTAL INTEGRITY 
| CATALOG @ UP TO 7 CONCURRENT REQUEST 
e BUFFER SPACE 
512 — EXTRA BUFFER 
1K — PER STRING 


( H.9.10 


SHARING A CATALOG ACROSS SYSTEMS 


SYSTEM SYSTEM 
A B 


CATALOG 


@ COMPLETE INTEGRITY 
@ NO RESTRICTIONS 


H.9.11 


) 


VSAM OPTIMIZATION 


Cl SIZE e BUFFER SPACE 

CA SIZE e FREE SPACE 
ALLOCATION e MULTIPLE VOLUMES 
INDEX OPTIONS @ SPEED/RECOVERY 
KEY COMPRESSION e 3350 


H.10.1 


[ 
ee ll A ee | 


Cl SIZE CONCERNS 
e DASD UTILIZATION 


e MULTIPLE BLOCKS 
e SPANNING A TRACK 


H.10.2 


CONTROL INTERVAL SIZE 
GENERAL PROCESSING GUIDELINES 


e SEQUENTIAL/SKIP SEQUENTIAL 


LARGER DATA Cl IMPROVES PERFORMANCE WITHIN 
THE TASK 


e DIRECT 


SMALLER DATA Cl IMPROVES PERFORMANCE WITHIN 
THE TASK 


e SEQUENTIAL/SKIP SEQUENTIAL AND DIRECT 
SMALLER DATA Cl 


MULTIPLE BUFFERS WHEN PROCESSING SEQUENTIALLY 





H.10.3 
Cw 
BUFFER SPACE 
SPECIFIED IN 
e DEFINE 
e ACB (OVERRIDES DEFINE)* 
e // DD (OVERRIDES ACB & DEFINE)* 
“MUST NOT BE LESS THAN VALUE OF DEFINE 
H.10.4 





SCHEDULING BUFFERS — DIRECT 


STRING 1 | STRING 2 
DATA DATA 
BUFFER 1] BUFFER 2 


DIRECT GET 
FROM CA, 





IS5 IS3 IS, 


SS; SS SS SS, SS SSp SS7 SSg SSg S51q SS), SS19 





H.10.5 
INDEX BUFFERS RECOMMENDATION 
DIRECT: 
MIN = #LEVELS — 1 + STRNO 
MAX = #INDEX SET RECORDS + STRNO 
SEQUENTIAL: 
STRNO 
H 10.6 





SCHEDULING BUFFERS — SEQUENTIAL/SKP 


DATA BUFFER 1 DATA BUFFER 2? DATA BUFFER 3 
—r az | Sd 
a 
SRS | Oe 
al 


ASSUME 3 DATA BUFFERS 
1 INDEX BUFFER 
6 CIS PER CA 
2 RECORDS PER Cl 


H.10.7 


CA SIZE 
e GOOD PERFORMANCE WHEN ENTIRE CAs NUMBER IN CYLINDER 


e THE LARGER THE CA: 
— THE FEWER THE PROBABILITIES OF CA SPLITS 
— THE FEWER THE READS OF SEQUENCE SET RECORDS 
— THE MORE CONSOLIDATED THE INDEX 


H.10.8 


C 





FREE SPACE EXAMPLE 


FSPC (20,10) CISZ (40 96) RESCZ (500,500) 
119 Cls/CA 


REC’D REC’D REC'D REC’D REC'D REC’D 
1 2 3 4 5 6 : 








BYTE # 500 1000 2500 3000 4086 
3266 CIDF 
FREESPACE RDFS 
THRESHOLD 
H.10.9 
FREESPACE CONSIDERATIONS 
® LARGE FREESPACE 
— MORE DASD SPACE 
— MORE 1/0 FOR SEQUENTIAL PROCESSING FOR SAME 
NUMBER OF RECORDS 
— MORE LEVELS OF INDEX, SO POSSIBLE INCREASE 
IN RUN TIME FOR DIRECT PROCESSING 
@ SMALL FREESPACE 


MORE CI/CA SPLITS 


AFTER SPLITS, MORE TIME FOR SEQUENTIAL 
PROCESSING WHEN FILE NOT IN PHYSICAL 
SEQUENCE 


H.10.10 





FREE SPACE ESTIMATION 
EVALUATE PRECENT AND UNIFORMITY OF GROWTH 
GROWTH 


@ EVENLY DISTRIBUTED 
— SPECIFY THAT PERCENT AS FREE SPACE 


e UNEVENLY DISTRIBUTED 
— SPECIFY SMALL PERCENT OF FREE SPACE 
— LOAD THE DATA SET 
— ALTER PERCENT OF FREE SPACE 





H.10.11 
c. L. 
WoLs : 
MULTIPLE VOLUME SUPPORT 
SPACE ALLOCATION cs 
“a é % if fo ee a 
"A PRIMARY ALLOCATION ON EACH VOLUME es ae ea em 


® WITHOUT KEYRANGE 
ACQUIRED FROM FIRST VOLUME WITH DEFINE 


ACQUIRED FROM OTHER VOLUMES WHEN 
NEEDED FOR EXTENSION OF FILE 


e WITH KEYRANGE 


ACQUIRED FROM EVERY VOLUME WITH 
DEFINE 


H.10.12 





EXAMPLE 1 


DEFINE e 
@ 


© CA 


fh 


VOLUMES (& S &) 


CYLINDERS (50 5) 





EXECUTION TIME EXTENSION 


DEFINE 


e@ PRIMARY SPACE ACQUIRED FROM FIRST VOLUME 


(NEED NOT BE VOLUME A) ae 


EXECUTION 
e USE REMAINING SPACE ON VOLUME 


; 
. as rtd 


IN SECONDARY EXTENTS 


e IF MORE SPACE REQUIRED TAKES PRIMARY ALLOCATION 


FROM NEXT VOLUME 
e REPEAT EXECUTION ALLOCATIONS 


H.10.13 


EXAMPLE 2 


DEFINE bd 
-  @ 


@ 
VOLUMES (A B C) 
~ 3 KEYRANGES ((00 30) (31 65) (66 99)) 
~---—--—-—> UNO RDERED 
CYLINDERS (50 5) 





(31-65) 


EXECUTION TIME EXTENSION 


DEFINE 
e PRIMARY ALLOCATION TAKEN FROM EACH VOLUME 


NOTE: IF ANY VOLUME DOES NOT HAVE SPACE FOR PRIMARY, 
SEVERAL MAY BE PLACED ON SAME VOLUME 


EXECUTION 


@e SECONDARY ALLOCATIONS FOR A KEYRANGE WILL BE ON VOLUME 
OF ITS PRIMARY ALLOCATION 


H.10.14 


we 


UNORDERED/ORDERED 


UNORDERED 


ORDERED 


PRIMARY ALLOCATION" MUST BE AVAILABLE ON ONE 
OF SPECIFIED VOLUMES OR DEFINE FAILS 


SECONDARY ALLOCATION MAY BE OBTAINED FROM 
ANY VOLUME 


SPACE IS ALLOCATED“ ON VOLUMES IN THE ORDER 
SPECIFIED IN THE VOLUMES PARAMETERS 


PRIMARY ALLOCATION MUST BE AVAILABLE ON FIRST 
VOLUME SPECIFIED OR DEFINE FAILS 


"PER KEY RANGE IF SPECIFIED 


H.10.15 


EXAMPLE 3 


DEFINE e 
6 


® Ne an eS 
VOLUMES (A B C) seach - 
ORDERED a 


CYLINDERS (50 5) : ese, tit 


ation i279) f- a ee 
SA Sa SS 
or 


EXECUTION TIME EXTENSION 


DEFINE 
e PRIMARY ALLOCATION TAKEN FROM VOLUME A OR DEFINE FAILS 


EXECUTION 
e USE REMAINING SPACE ON VOLUME A IN SECONDARY EXTENTS 


e IF MORE SPACE REQUIRED TAKE PRIMARY ALLOCATION FROM 
VOLUME B; IF NOT POSSIBLE, REQUEST IS REJECTED 


e REPEAT FOR VOLUME C. 


fy ” ’ * 
ye Z. H.10.16 
ae ee ae a =, f w S . 
Be og! 3 \ a Hi Pe = 
: we Me : - ie * 





INDEX OPTIONS 


e INDEX AND DATA ON SEPARATE VOLUMES 
— SIMULTANEOUS ACCESS TO INDEX AND DATA 
- INDEX ON FASTER DEVICE 
- SPECIFY VOLUMES AT DATA AND INDEX LEVELS 


e SEQUENCE SET IMBEDDED IN CAs 
— SEQUENCE SET ALSO REPLICATED 
— DISK ARM MOVEMENT REDUCED 
— SPECIFY IMBED AT EITHER CLUSTER OR INDEX LEVELS 


e INDEX RECORDS REPLICATED 


— INDEX SET AND SEQUENCE SET REPLICATED 
—- ROTATIONAL DELAY REDUCED 
— SPECIFY REPLICATE AT EITHER CLUSTER OR INDEX LEVELS 


H.10.17 


SS, SS 


INDEX OPTIONS* — Vey Wit 





“2 VOLUMES ARE SHOWN, COULD BE 2 AREAS 
ON 1 VOLUME 


H.10.18 





RECOVERY EXAMPLE 


PREFORMATTING 


| 00000 ——$—___—_—_—-——+| cipF | 
| 00000 SSS eee CIDF | 
| 00000 Se CIDF | 
| 00000 ——_—___—_________ | CIDF | 


| SEOF | 
ena 
re ee ne 
as oe eed 


LOADING 
10 | 15 | 20 RDF| RDF! CIDF 
30 | 35 | 40 RDF|RDF| CIDF 
50 RDF] CIDF 


| [ CIDE | 


| SEOF | 
ee rere? 
[ane Sener eee nee! 


a ee 


CAI 


CA2 


CAl 


CA2 


H.10.19 





SPEED EXAMPLE 


LOADING 
10 15 20 RDF |RDF|CIDF 
30 35 40 RDF |RDF|CIDF 
CA1 
50 RDF|CIDF 


H.10.20 


INDEX KEY COMPRESSION 


MINIMIZE KEY SIZE 

MINIMIZE BYTES EXAMINED 

MAXIMIZE INDEX FAN-OUT 

FEWER INDEX LEVELS ——@ FASTER KEYED ACCESS 
FRONT COMPRESSION 

REAR COMPRESSION 

DIFFERENCES BETWEEN KEYS — NOT IDENTIFICATION 

OF COMPLETE KEY 

INDEX ONLY — KEYS NOT COMPRESSED IN DATA RECORD 


H.10.21 


REAR KEY COMPRESSION 








Cl 2 
CONTROL COMPLETE KEY AFTER REAR 
INTERVAL KEY KEY COMPRESSION 
Cl 1 (10001) * 1000-- 
10009 ** 
Cl 2 (10052) 100—— 
10080 
Cl 3 (10222) 10333 
10333 
Cl 4 (10334) 1400- 
14000 
Cl 5 (14021) ——— 
14028 
Cl 6 (23456) 2363— 
23630 
Cl 7 (23685) 


"FIRST KEY IN THE CONTROL INTERVAL 
**LAST KEY IN THE CONTROL INTERVAL 


H.10.22 


CONTROL 


INTERVAL 


Cl 1 
Cl 
Cl 
Cl 
Cl 
Cl 


Oo Om F& W NHN 


FRONT KEY COMPRESSION 


COMPLETE 


KEY 


10009 
10080 
10033 
14000 
14028 
23630 


SL eT LE EE Ee aE a I EE SE a TET IE I 82 RET ST ET TESTE PETES 


FRONT COMPRESSION 


COMPRESSION 





REAR KEY AFTER FRONT 
KEY COMPRESSION 


1000 - 1000 
100 

10333 = = 333 
1400 400 
aa ean eoetes 
2363— 2363— 


H.10.23 





KEY COMPRESSION 


BEST WHEN MANY KEYS HAVE SAME LEADING 


CHARACTERS 


REAR COMPRESSION 


BEST WHEN KEYS HAVE LARGE DIFFERENCES 
IN RIGHTMOST CHARACTERS 


H.10.24 


3850 OPTIONS 
OPEN: BIND 
CYLINDERFAULT 
STAGE 


CLOSE: DESTAGEWAIT 
NODESTAGEWAIT 


H.10.25 


MVS MASTER CATALOG 


VSAM CATALOG STRUCTURE 


ENTRIES FOR SYSTEM DATA SETS 


ENTRIES FOR CATALOGS 


CREATED AT SYSGEN 


LOCATED VIA ‘SYSCATLG’ MEMBER IN 
SYS1.NUCLEUS 


H.11.1 


BACKUP 


@ VOLUME BACKUP WITH STANDALONE RESTORE 


OR 


@® DUPLICATE CATALOG 
DEFINE UCAT 
LOAD UCAT - Eg REPRO 
ENTRY IN SYS1.NUCLEUS 


a Fe 








IPL WITH DUPLICATE CATALOG 


1. ADDRESS STOP AT IEAVNP11 


ee ALTER CONSTANT AT @CCOQ2209 


QUALIFIED NAMES 


USER CATALOG 









MASTER CATALOG 





FO4V.PAYROLL.CLUSTER 
EDCTV.ENROLL.CLUSTER 











FO4V.UCAT 
EDCTV-ALIAS 
SYSCATLG.VOIABCD 
FO4N-ALIAS 
EDCTN-ALIAS 






CVOL 









FO4N.HOURS.5AM 
EDCTN.GRADES.SAM 


H.11.3 





H.11.4 


a ESTABLISH CVOL POINTER 


DEFINE NONVSAM 


NAME (SYSCTLG.VVOLOO1) - 
DEVICE TYPES (2314) - 
VOLUMES (VOLO0O1) 


The first qualifier Must Be ‘SYSCTLG’. 


MASTER 


SYSCTLG.VVOLOO1 





4 H.11.5 





ESTABLISH ALIAS 


DEFINE ALIAS — 
NAME (A) — 


RELATE (SYSCTLG.VVOLO01) 


DEFINE ALIAS NAME (B) RELATE (SYSCTLG.VVOLO001) 


MASTER CVOL 





SYSCTLG.VVOLOO1 





A.C 
B.C 


H.11.6 





CONVERT CVOL TO VSAM UCAT 


// MVE EXEC IDCAMS 

// OSCAT DD DSN=SYSCATLG,VOL=SER=CAT004, 
/ UNIT=3330 

// SYSPRINT DD SYSOUT=A 

// SYSIN : 


CNVTCAT INFILE (OSCAT) CAT (AECUCAT) 


SYSCATLG: 


EDN.SAVINGS 
EDN.VISUAL 
FO4N.RUNS 





H.11.7 


¢ 


GENERIC NAMES AND LISTC, DEL, ALTER 


LISTCAT ENTRIES (F04V.*.PRIOR.CLUSTER) 


will list: FO4V.anyname.PRIOR.CLUSTER 


as in FO4V.ENROLL.PRIOR.CLUSTER 
FO4V.MACHINE.PRIOR.CLUSTER 


But not 







“PRIOR.CLUSTER.ADDED 
FO4V.MAC PRIOR.AIX 


f H.11.8 











LEVEL PARAMETER 


LISTCAT LEVEL (F04V) 


includes FO4v.ENROLL.PRIOR.CLUSTER 
FO4V. ROSTER. AFTER.CLUSTER 
FO4V.GRADES.CLUSTER 
FO4V.MACHINE.PRIOR.CLUSTER 


LISTCAT LEVEL (F04V.*.PRIOR) 


includes FO4V.ENROLL.PRIOR.CLUSTER 
FO4V.MACHINE.PRIOR.CLUSTER 




















H.11.9 
CATALOG SEARCH ALGORITHM 
Search F 
STEPCAT EXIT 
DSN Set 
Quallfled RC =NF 
: 7 
Set Search MCAT Allocate 
RC» NF for FLQ= and 
ST oe aa 
maa Seorch 
F = Found e H.1110 
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INTRODUCTION 


Virtual Storage Access Method (VSAM) is an access method for use with 
OS/VS1 and OS/VS2. VSAM is used with direct-access storage to provide 
fast storage and retrieval of data. 


VSAM’s record format is different from that of other access methods. All 
VSAM records are stored in control intervals. A control interval is a 
continuous segment of auxiliary storage. The records are ordered according to 
values in a key field or according to when they were stored. With 
key-sequenced data sets, the user can gain access to a record by specifying its 
key or its relative byte address (RBA). With entry-sequenced data sets, the 
user can gain access to a record only by specifying its RBA. For additional 
information on VSAM records and how they are stored, see “‘Data Areas.” 


User programs that contain Indexed Sequential Access Method (ISAM) 
macros can be used to process records in a VSAM data set. The ISAM 
interface program that allows the use of ISAM macros builds the necessary 
VSAM contro! blocks when an OPEN macro is issued and ensures that 
VSAM contro! blocks are properly initialized when subsequent requests are 
made for reading or writing records. 


Most of VSAM resides in the pageable link pack area in the common area of 
virtual storage. Figure 1 illustrates VSAM’s relationship to OS/VS2, to the 
processing program, and to the data stored on a direct-access storage device 
and in mass storage. The subpools indicated in the figure (230, 231, 239, 241, 
245, 250, 252) contain VSAM contro! blocks. For more information see 
“Virtual-Storage Management” in “‘Diagnostic Aids.” 


VSAM is controlled by user macros. These macros are expanded into calling 
sequences to VSAM functions. For additional information on user macros, 
see OS/VS Virtual Storage Access Method (VSAM) Programmer's Guide 
and OS/VS Access Method Services. 


VSAM communicates with other parts of the operating system through the 
SVC processor and through VS2 control blocks used by VSAM. In addition 
to the VS2 control blocks used by VSAM, VSAM builds and uses the 
access-method control block (ACB). The ACB describes a VSAM data set in 
much the same way that a DCB describes a nonVSAM data set. 


In addition to processing records and data sets, VSAM opens and closes data 
sets and does most of its own space management, that is, VSAM makes only 
minor use of VS2 Open and Close and relies on VWS2 DADSM for only part of 
its space management. To do much of this work, VSAM uses the VS2 catalog. 
VS2 catalogs contain a description of VSAM space, where available space is, 
how space is used, and the location of data sets. For additional information on 
the catalog, see OS/VS2 Catalog Management Logic. 


VSAM is logically grouped into the following functional areas: 


“e Data-Set Management (sometimes referred to in program documentation 


as “I/O Support’), which comprises Open and Close for VSAM and for 
the ISAM Interface, Virtual-Storage Management, and BLDVRP/DLVRP 
processing 


— Open connects a user’s program to a VSAM data set and builds the 
control blocks required to permit the user to read from and write to the 
data set. 
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Virtual Storage 
| igh Ad 
c System Queue Area (Subpool 245) High Address | 
Common Area 
(Global Storage) Pageable Link eer 
Pack Area VSAM) 
~ 
¢ 


~.. | Common Service Area (Subpools 231 and 239) 
Local System Queue Area 


Scheduler Work Area 


Subpool 230 


User’s Private Address Spaces 
(Local Storage) 










Contents of 


Direct-Access 
Control Intervals i : 


Subpool 250 (1/O Buffers) 


Storage 


Subpool 252 





Data 
Records 





Staged 
Data 


System Area (VSAM 


I/O Management) 


Nucleus 


Mass Storage 





Low Address 


Figure 1. Relationship of VSAM, OS/VS2, User’s Processing Program, and Stored Data 


— Close disconnects a user’s program from a data set and releases the data 
set’s control blocks built by Open. Close also updates statistics in the 
catalog. 





— Virtual-Storage Management centralizes the processing of most requests 
for virtual storage. 


- BLDVRP/DLVRP processing builds and deletes VSAM resource pools 
for processing with local or global shared resources. (Processing with 
shared resources is described from the user’s point of view in OS/VS 
VSAM Options for Advanced Applications.) 

e Record Management, which comprises processing to satisfy user requests 
for access to data, including end-of-volume processing 


— Data-Request Processing requests I/O Management to read and write 
Cc. records in response to user-issued VSAM and ISAM macros (the latter 
by way of the ISAM Interface). It also requests 1/O Management to 4 
read and write records for VS2 Catalog Management. 
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— End of Volume mounts volumes and allocates space. It modifies the 
existing control blocks to reflect the newly mounted volumes and newly 
allocated space. 


Control Block Manipulation, which allows a user’s program to generate 
some control blocks (ACB, EXLST, and RPL) dynamically and to modify, 
display, and test their contents 


I/O Management, which comprises the Problem-State I/O Driver, the 
Supervisor-State I/O Driver, the Actual Block Processor, end appendages, 
an asynchronous routine, and a purge routine 


— The drivers and the Actual Block Processor translate requests for access 
to the contents of control intervals to requests for reading and writing 
physical records. They build a channel program to give to the VS2 I/O 
Supervisor. 

— The appendages and the asynchronous routine get control back to the 
requester after I/O is finished. 
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Control Block Interrelationships 


Cc Figure 47 and 48 show the VSAM control blocks built when a key-sequenced 
data set is opened. , ¢ 


The role of the BIB and CMB in virtual-storage management is described in 
“‘Virtual-Storage Management” in “Diagnostic Aids.” 





- 
System Control Blocks 














User’s Record | 
Management Request : Current TCB Jobstep TCB JSCB 
GET, PUT, or POINT ! tJobstep TCB tISCB | tAMBL 
| tDEB (dummy) DEB chain chain 
User-Supplied l 
Control Blocks = a ane en SS eae ane ae aT TO LS ee 
Seer etapa " jag na I~ 

VSAM User Rl Data 
Block 
Structure 

RPLs 











Describes 








ed the VSAM Index 
Record BEE | Control ¢ 
Processing | Block 
Request Describes Structure 
the VSAM | 
Data Set | 
AMBL CMB 
| 
| tIndex AMB 
tRecord | 
Management 
eXTST Load Module | 
BIB 3 
User Exit tEXLST nee , 
i anagemen 
(dummy) ; Load Module Do 
| VMTs 
| | 
| 
ee a aes 
4 Note: The data control block structure is shown in Figure 52. The index contro! block it-ucture is shown in 


Figure 54. ; 
Figure 47. VSAM Control Block Structure for a Key-Sequenced Data Set (VSAM User) { 
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Management Record 


Management 
Program 
Load Module 


ee ee ee ee ee 

Built by | Built by ISAM- { Built by VSAM Open 

ISAM-User’s Interface Open | AMBL 

ioe | | 

n | | Data 

e 
tDCB Control 

| ACB | Block 
tRecord 
| 


Index 


Load Module 
Control 


Block 
Structure 





tEXLST 


tISAM- 
Interface 
Routines 





tDEB (dummy) 





w 


DEB (dummy) 





z 
EXLST | 
ice [nena || 
rsnao |!) a 
[se0paD | 
! 
| BIB 
. 
ISAM-Interface | eed 
Routines | VMTs 
| 
| 
| 


Note: The data contro! block structure is shown in Figure 52. The index control block structure is shown in 
Figure 54. 
Figure 48. VSAM Control! Block Structure for a Key-Sequenced Data Set (ISAM User) 
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ACB—Access Method Control Block 





The VSAM ACB describes a VSAM cluster. It is built by the user’s program 

with the ACB or GENCB macro. Before the cluster is opened, the ACB can 

be modified by the user’s DD statements and by the MODCB macro. After ( 
the cluster is opened, the ACB is pointed to by the RPL (RPLDACB) that 

describes the user’s record processing request. 


” 


. Access Method Control Block (ACB)—Description and Format 
Bytes and 
Offset Bi Pattern Field Name Description 
0 (0) 1 ACBID Control block identifier, X‘AO’ 
1(1) 1 ACBSTYP Subtype: 
X‘10’ = VSAM 
X‘20’ = VTAM 
2 (2) ACBLENG Length of the ACB 
4 (4) 4 ACBAMBL Address of the AMBL 
ACBIXLST Address of the index list 
ACBJWA 
ACBIBCT 
8 (8) 4 ACBINRTN Address of the VSAM Interface routine 
(IDA019R1) 
12 (C) 2 ACBMACRF MACRF flags: 
ACBMACRI MACRF flag byte 1: 
er ACBKEY The record is identified by a 
key—keyed processing 
Pa eae ACBADR The record is identified by aRBA 
ACBADD (relative byte address)—addressed 
processing { 
so lex ACBCNV Control interval processing : 
ACBBLK 
eis Misede ACBSEQ Sequential processing 
ere ere ACBDIR Direct processing 
Bra ACBIN Input (GET, READ) processing 
els ACBOUT Output (PUT, WRITE) processing 
Sdisheed 1 ACBUBF User-supplied buffer space 
13 (D) ACBMACR2 MACRF flag byte 2: 
bated ie ACBSKP Skip sequential processing 
eee Ngee ACBLOGON VTAM LOGON indicator 
wie dse ACBRST Set data set to empty state 
a ACBDSN Basic subtask shared control-block 
connection on common DSNAMEs 
Sees 1 ACBAIX Object to be processed is the alternate index 
of the path specified in the given DDNAME 
XXX. .... Reserved 
14 (E) 1 ACBBSTNO Number of concurrent strings for 
alternate-index path 
15 (F) 1 ACBSTRNO Number of RPL strings 
16 (10) 2 ACBBUFND Number of buffers requested for data 
18 (12) 2 ACBBUFNI Number of buffers requested for index 
20 (14) 4 ACBBUFPL Address of the buffer header (BUFC) 
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Access Method Control Block (ACB)—Description and Format 


ACBMACR3 


ACBLSR 
ACBGSR 
ACBICI 
ACBDFR 
ACBSIS 
ACBNCFX 


ACBMACR4 
ACBJBUF 

ACBRECFM 
ACBRECAF 
ACBCCTYP 


ACBASA 
ACBOPT 


ACBCROPS 
ACBCRNCK 


ACBCRNRE 


ACBDSORG 


ACBMSGAR 
ACBPASSW 


ACBEXLST 
ACBUEL 


ACBDDNM 


ACBTIOT 
ACBINFL 
ACBAMETH 
ACBERFL 
ACBDEB 


ACBOFLGS 


ACBEOV 
ACBOPEN 
ACBDSERR 


ACBEXFG 
ACBIOSFG 


Bytes and 
Offset Bit Pattern Field Name 
20 (14) 1 
x eee 
me eer 
ws 
MesecGs x 
21 (15) 1 
22 (16) 2 
24 (18) 1 
Teskees 
25 (19) 1 
.. XXXX 
26 (1A) 2 
XX.. wee. 
| Paes 
es ae 
weXX XXXX 
XXXX .XXX 
28 (1C) 4 
32 (20) 4 
36 (24) 4 
Before OPEN 
40 (28) 8 
After OPEN 
40 (28) 2 
42 (2A) 1 
43 (2B) 1 
44 (2C) 1 
45 (2D) 3 
Not Changed by OPEN 
48 (30) 1 
ae are 
een 
eoee ues 1 
XX.. .X.. 


Description 
MACRF flag byte 3: 


Local shared resource 

Global shared resources 

Improved control-interval access 
Write operations are to be deferred 
Sequential insert strategy 

Control blocks are fixed in real storage 
Reserved 


Reserved 

Number of buffers requested for journal 
Record format: 

JES format 

Control character: 


Reserved 

Control character type 

Non-user options: 

Byte 1: 

Checkpoint/restart options: 

Restart hasn't checked for modification since 
last checkpoint 

Data added since last checkpoint hasn't been 
erased by restart, and no reposition to last 
checkpoint takes place 

Reserved 


Byte 2: 
Match with DCBDSORG 
Reserved 


Message area 
Address of the user-supplied password 
Address of the user exit list 


DD name 


Offset to the TIOT 
Indicator flags 
Access method type 
Error flags 

Address of the DEB 


Open/Close flags: 


EOV concatenation 

The ACB is open 

No further requests are possible against 
the ACB 

An ACB Exit routine exists 

The Open or Close routine is in control 
Reserved 
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Cc. 


Access Method Control Block (ACB)—Description and Format 


Bytes and 
Offset Bik Pattern 
49 (31) 1 
& $0 (32) 2 
Py ear 
pm ees 
eke: 
Pe 
X.. x 
§1 (33) 1 
§2 (34) 4 
56 (38) 4 
60 (3C) 2 
62 (3E) 2 
64 (40) 
68 (44) 
72 (48) 4 
AMB—Access Method Block 


Field Name 
ACBERFLG 


ACBINFLG 


ACBJEPS 
ACBIJRQE 
ACBCAT 
ACBSCRA 


ACBUCRA 


ACBSDS 


ACBUJFCB 
ACBBUFSP 
ACBBLKSZ 


ACBMSGLEN 


ACBLRECL 
ACBUAPTR 


ACBCBMWA 


ACBAPID 


Error flags 

Note: See ‘‘Open and Close Return Codes” 
in ‘Diagnostic Aids” for details on the 
ACBERFLG error flags. 


Indicator flags: 


JEPS processing 

RQE being held by JAM 

The ACB describes a VSAM catalog 

Catalog recovery area is built 

in system storage 

Catalog recovery area is built in user's 
storage 

A VSAM data set is being opened as a system 
data set 

Reserved 


Reserved 

Address of the user JFCB 

Amount of space available for the buffers 
Length of the physical DASD record 
Message length 

Length of the user’s record 

Address of the user’s work area 


Address of the work area for control block 
manipulation 


Address of application ID  ¥ 


The AMB describes a VSAM data set or index and points to control blocks 

< needed to process data set and index records, such as the BUFC, the PLH, 
the catalog’s ACB, and the AMDSB. An AMB is built for a cluster’s data set 
and, if the cluster is key-sequenced, an AMB is built for the index. Each 
AMB associated with the cluster is pointed to by the AMBL (AMBLDTA 
points to the data AMB; AMBLIX points to the index AMB). When a data 
set’s or index’s record is being processed by VSAM record management, 
register 3 (RAMB) points to the data set’s or index’s AMB. 


Access Method Block (AMB)—Description and Format 


Bytes and 
Offset Bit Pattern 
0 (0) 1 
1 (1) 1 
2 (2) 2 
4 (4) 4 
8 (8) 4 
12 (C) 4 
16 (10) 4 
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Field Name 
AMBID 
AMBRSC 
AMBLEN 
AMBLINK 
AMBBUFC 


AMBPH 
AMBCACB 


Description 

Control block identifier, X‘40’ 

Resource TS byte 

Length of the AMB 

Address of the next AMB in the AMB chain 


Address of the BUFC associated with the , 
AMB 


Address of the PLH associated with the AMB 


Address of the VSAM catalog’s ACB (the 
ACB of the catalog that contains the object's §) 
catalog record) 


EXLST—Exit List 
The EXLST contains the addresses of exit routines supplied by the user. It is 


created by the user with the EXLST or GENCB macro. The EXLST is 
Cc pointed to by the ACB (ACBEXLST). 
Exit List (EXLST)—Description and Format 
Bytes and 
Offset Bit Pattern Field Name Description 
= 0 (0) ] EXLID Control! block identifier, X°81’ 
1(1) ] EXLSTYP Subtype identifier: 
X‘10’ = VSAM 
X‘20° = VTAM 
2 (2) 2 EXLLEN Length of the control block 
4 (4) 1 Reserved 
5 (5) 1 EXLEODF Entry description 
6 (6) 4 EXLEODP Address of the EODAD exit routine 
10 (A) 1 EXLSYNF Entry description 
11 (B) 4 EXLSYNP Address of the SYNAD exit routine 
15 (F) 1 EXLLERF Entry description 
16 (10) 4 EXLLERP Address of the LERAD exit routine 
20 (14) 10 Reserved ‘ 
30 (1E) 1 EXLJRNF Entry description 
31 (1F) 4 EXLJRNP Address of the JRNAD exit routine 
35 (23) 10 Reserved 
~— HEB—Header Element Block 


The HEB is used by VSAM Virtual-Storage Management to allocate and free 
unprotected storage blocks. It contains 16 header elements, each of which 
describes a storage block. It is further described in “Virtual-Storage 
Management” in “Diagnostic Aids.” 


The HEB is pointed to by the BIB (BIBHEBPT). The first free header 
element is pointed to by BIBHEBFQ. 


Header Element Block (HEB)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
HEB Block Definition 
0 (0) 1 HEBID Control block identifier, X*13’ 
1(1) 1 Reserved 
2 (2) 2 HEBLEN Length of the HEB (including header 
elements) 
4 (4) 4 HEBNHEB Address of the next HEB (or 0) 
8 (8) 2 Reserved 
10(A) = 2 HEBCNT Number of header elements 
12 (C) 20x16 | HEBHDELS Header elements: 
HEB Header Element Definition 
0 (0) 8 HEBFREMN Information for freeing the storage block 
Cc ge ste | described by this header element: 
0 (0) 1 HEBSP = Subpool in which the storage block is located 


334 OS/VS2 Virtual Storage Access Method (VSAM) Logic 
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Cc 


Index Create Work Area (ICWA)—Description and Format 


Offset 

42 (2A) 
44 (2C) 
46 (2E) 
48 (30) 
50 (32) 
$2 (34) 
54 (36) 
53 (37) 
56 (38) 


57 (39) 


58 (3A) 


59 (38) 


60 (3C) 
VL 
VL 


Bytes and 


Bk Pattern 


—— =a =m NY NN N N NN 


(key length) 
(key length) 
(key length) 


IICB—ISAM Interface Control Block 


Field Name 
ICWKEY IL 
ICWKEY2L 
ICWKEY3L 
ICWNEST 
ICWNOSEG 
ICWCRSEG 
ICWREQ 
ICWPTL 
ICWCER 


ICWCEF 


ICWCEL 


ICWCERP 


ICWKEY1 
ICWKEY2 
ICWKEY3 


Description - 

Length of the current key 

Length of the previous key 

Length of the section key 

Number of entries in the index section 
Number of segments in a spanned record 
Number of the segment being processed 
Request type 

Index entry pointer length 


Rear compression count of the current index 
entry 


Current index entry F—number of front-key 
compressed bytes 


Current index entry L—length of the 
compressed key in the entry 


Rear compression count of the previous 
index entry 


Save area for the current key 
Save area for the previous key 


Save area for the section key 


The IICB is used to address the DCB (ISAM) and the ACB and RPL 
(VSAM) control blocks and associated areas needed by the ISAM interface. 


The IICB is pointed to by the DEBWKPTS field in the ISAM DEB to provide 


integrity and by the RPLICB field in the RPL Extension to provide the 
connection to VSAM control programs. 


ISAM Interface Control Block (IICB)—Description and Format 


Offset 
0 (0) 
1 (1) 
2 (2) 
4 (4) 
8 (8) 
12 (C) 
16(10) 
16 (10) 
18 (12) 
20 (14) 
24 (18) 


Bytes and 
Bit Pattern 


-_, 


=a & NN & 2S 2 AN = 





Field Name 
IICBID 


TICBLEN 
IIDCBPTR 
TIACBPTR 
IIRPLPTR 
ITW1CBF 
ISAVLRL 
NMAXLRL 
IIKEYPT 
IIFLAG1 


IIFSCAN 
HFGET 
IIFPASS 
IIFCLOSE 
TIDATA 





Description 

Control block identifier, X‘80’ 

Reserved 

Length of IICB, in bytes 

Address of DCB 

Address of ACB 

Address of RPL 

Address of dummy scan work area 
Length of current record 

Maximum record length 

Address of key (dummy ISAM) save area 
ISAM interface status flags: ‘ 


Scan mode 

First GET request 
First pass in load mode 
Close in process 

Data only retrieval 


¢ 





a. 


Peek A ae: eh. eg 


= 





j 
t 


ole A 


} Bs Ne 





Pe 


ISAM Interface Control Block (TICB)—Description and Format 


Bytes and 
Offset Bk Pattern 


25 (19) 3 
28 (IC) 1 
—— 
ce 
Ax 
wale 
al. 
seated 1 
29 (1D) 3 
32 (20) 2 
34 (22) 2 
36 (24) 1 
Pete te 
XXX XXXX 
37 (25) 
40 (28) 4 
44 (2C) 
45 (2D) 3 
48 (30) 4 
$2 (34) : 
60 (3C) 72 
60 (3C) 
64 (40) 
68 (44) 4 
72 (48) 60 
132 (84) 36 
132(84) 4 
132 (84) 1 
feiees 
le. 
- 
oe XK. 


Field Name 


TIFTEST 
NISEQCHK 
NQBFRS 


NACBL 


IIFLAG2 


MRKP 
MLRECL 
MBLKSI 
MOPTCD 
MRECFM 
MBUFL 
MBUFNO 
MKEYLE 


TIRPLL 


TIKEYSL 
IIBUFL 


IiFLAG3 
MBFALN 


IIMSGL 
IIMSGPTR 
IIBUFNO 


ITTBUFL 


IISVCLST 
IISAMSYN 


IIREGSAV 


MREGBC 
IIREGFC 


HAUD 
NAUDHDR 
IIAUDFLI 


AUDACBOP 
AUDACBRO 
AUDDCBEX 
AUDDCBRT 
AUDPRMOD 


s 
Description 
Loop test bit 
Resume load sequence check 


QISAM does not use buffers—no 
FREEMAIN is required 


ACB, EXLST, IICB length for 
GETMAIN/FREEMAIN 


ISAM interface status flags used by Open to 
designate the fields being merged by ISAM 
Interface. ISAM Interface Close uses the 
same mask to restore the DCB to its pre-open 
status. 


Relative key position 
Logical record length 
Block size 

Option code 

Record format 
Buffer length 

Buffer number 


Key length 


RPL and RPLE: length for 
GETMAIN/FREEMAIN 


Length of key save area, in bytes 


Length of single ISAM Interface buffer (used 
in calculations) 


ISAM interface status flags: 


BFALN merge bit 
Reserved 


Message area length 
Message area pointer 


Number of ISAM Interface buffers built by 
Open 


Total BCB and buffer length for 
GETMAIN/FREEMAIN 


SVC exit for SYNADAF 


ISAM SYNAD name—used when SYNAD is 
specified in the AMP parameter 


Register save area 
Reserved 

Previous save area pointer 
Next save area pointer 
Remainder of save area 


Audit information 


Audit flags 


OPEN was issued for ACB 

Control was returned from Open 

A DCB exit was taken 

Control was returned from the DCB exit 
A processing module was loaded: 
‘OLV'IDAIIPM1 
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ISAM Interface Control Block (IICB)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
" ‘10° IDAIIPM2 é 
*11°IDAIITPM3 
Pee AUDIISYN ISAM-Interface SYNAD routine was loaded 
Games 1 AUDURSYN User SYNAD routine was loaded 
- 133 (85) 1 INAUDFL2 Audit flags 
| ees AUDIIFBF IDAIIFBF was loaded 
sl earaeee AUDACBCL CLOSE was issued for ACB 
a eee AUDACBRC Control was returned from Close 
nee eae AUDBFREX A flush-buffer exit was taken to IDAIIPM1 
re bee AUDBRFRT Control was returned from IDAIIPM1 
Pry ee AUDDEBXF The DEB extension was freed 
Bsus XX Reserved 
134 (86) 2 IIGMCNTR Offset from ITAUD to the next available 
entry in the audit-information fields 
136 (88) 32 NGMAUD Address of virtual-storage areas gotten 
136 (88) 4 AUDIICB Address of this IICB 
140 (8C) 4 AUDCSPLI Subpool number and length 
140 (8C) l AUDCSPI Subpool number 
141 (8D) 3 AUDCLI Length 
144 (90) 4 AUDCDEB Address of the DEB 
148 (94) 4 AUDCSPLD Subpool number and length 
148 (94) 1 AUDCSPD Subpool number 
149 (95) 3 AUDCLD Length 
152 (98) 4 AUDCBFRS Address of the area for buffers and RPLs é 
a 156(9C) 4 AUDCSPLB —_Subpool number and length . 
156 (9C) 1 AUDCSPB Subpool number 
157 (9D) 3 AUDCLB Length 
: 160 (AO) 4 AUDCMSGA Address of the physical-error message area 
164 (A4) 4 AUDCSPLM Subpool number and length 
164 (A4) 1 AUDCSPM Subpool number 
165 (A5) 3 AUDCLM Length 


IM WA—Index Insert Work Area 


The IMWA is a control block used in inserting an index entry into the index 
of a key-sequenced data set. The IMWA is created by the Open routine, and 
is pointed to by the ICWA (ICWCHN). 


Index Modification Work Area (IMW A)—Description and Format 





Bytes and 
Offset Bi Pattern Fieid Name Description 
0 (0) 1. IMWID Control Block identifier, X‘42’ 
1 (1) 1 IMWFLAGS Control flags: 
| eres IMWNEWHL Indicates a new high level should be built 
in the index structure 
ere IMWRIPL Indicates a new entry must be built in an 
index record at the next higher level to 
. reflect a new index record created by an 
é index split 
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RPL—Request Parameter List 


The RPL contains user-request information and error feedback information. 
It also contains information required by GET and PUT macros. 


The RPL is created by the user with the RPL or the GENCB macro. 
Request Parameter List (RPL)—Description and Format 


4 Offset 
0 (0) 
0 (0) 
1 (1) 


2 (2) 


3 (3) 
4(4) 
8 (8) 


9 (9) 


12 (C) 
12 (C) 


13 (D) 


13 (D) 


, x 


Bytes and 
Bk Pattern 


4 
1 
1 


X*00" 
x'04' 


Field Name 
RPLIDWD 
RPLID 
RPLSTYP 


RPLREQ 


RPLLEN 
RPLPLHPT 
RPLECB 


RPLWAIT 
RPLPOST 


RPLFDBWD 
RPLSTAT 


RPLCHKI 
RPLEDRQI 


RPLFDBK 


RPLRTNCD 
RPLERREG 


as 


Description 

Identification word of the RPL: 

Control block identifier, X‘00° 

RPL subtype: 

X‘10° = VSAM 

X*20° = VTAM 

Request type—when the user issues a VSAM 
macro, register 0 contains one of the 
following request-type codes; when VSAM 
processes the request, the request-type code 


in register O is transferred to the RPLREQ 
field (unless the request is CHECK or 


ENDREQ) 

o(0) GET request 

1(1) PUT request 

2(2) CHECK request 

3(3) POINT request 

4(4) ENDREQ request 

5(5) ERASE request 

6(6) VERIFY request 

8(8) Data preformat request 
9(9) Index preformat request 
10(A) Force I/O request 
11(B) GETIX request 

12(C) PUTIX request 

13(D) SCHBFR request 

14(E) MRKBFR request 
15(F) WRTBEFER request 
Length of the RPL 

Address of the PLH 


Address of the external ECB, or an internal 
ECB: 


The event has not yet completed 
The event has completed 
Reserved 


Reserved, if RPLECB is an internal ECB, or 
the address of the external ECB 


Feedback work: 
RPL status flags: 


CHECK has been issued 
ENDREQ has been issued 
Reserved 


RPL feedback area (See “Diagnostic Aids” 
for a list of RPL return codes and condition 
codes.) 


RPL return code 


Normal return 
Invalid control block 
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Request Parameter List (RPL)—Description and Format 


Offset 


, 14 (E) 
14 (E) 
15 (F) 
16 (10) 


18 (12) 
20 (14) 
24 (18) 
28 (1C) 


32 (20) 
36 (24) 
40 (28) 
40 (28) 





41 (29) 
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Bytes and 


Bk Pattern Field Name 


X08’ 
x‘oc’ 
2 


1 
1 
2 


a A A NWN 


RPLCNDCD 
RPLCMPON 
RPLERRCD 


RPLKEYLE 
RPLKEYL 


RPLSTRID 
RPLCCHAR 
RPLDACB 
RPLTCBPT 


RPLAREA 
RPLARG 
RPLOPTCD 
RPLOPT1 
RPLLOC 
RPLDIR 
RPLSEQ 


RPLSKP 
RPLASY 


RPLKGE 
RPLGEN 
RPLECBSW 


RPLOPT2 


RPLKEY 
RPLADR 
RPLADD 
RPLCNV 


RPLBWD 
RPLLRD 


RPLUPD 
RPLNSP 


Description 


Logical error 
Physical error 


RPL condition code 
Component issuing the code 
Error code 

Key length 


RPL string identifier 
Address of the contro! character 
Address of the caller's ACB 


Address of the user’s TCB—this field is 
always zero for a VSAM RPL 


Address of the caller’s record area 
Address of the caller’s search argument 


Option flags 
Option flag byte 1: 


Locate mode . 
Move mode 

Direct-search access 

Sequential access 

Skip sequential processing 
Asynchronous request 

Synchronous request 

Search key greater than or equal c 
Search key equal 

Generic key 

Full key 

The RPLECB field contains the 
ECB’s address 


Option flag byte 2: 


Locate the record identified by a key 
Locate the record at the caller-specified 
relative byte address (RBA) 

Locate the contro! interval at the 
caller-specified RBA 

Process in backward direction 
Locate or retrieve the last 

record in the data set 

Update processing 

Note the string position 

Reserved 





Request Parameter List (RPL)—Description and Format 


Offset 
42 (2A) 


43 (2B) 
44 (2C) 


48 (30) 
$2 (34) 
56 (38) 
60 (3C) 
60 (3C) 
62 (3E) 


63 (3F) 
64 (40) 
68 (44) 
69 (45) 
70 (46) 
72 (48) 


Bytes and 
Bi Pattern 


1 


— VN 8 Aa ab A 


- N —_ —_= PR — 


RPLE—Request Parameter List Extension 


An RPLE is built and appended to each ISAM Interface RPL when the user’s 
ISAM program opens a VSAM cluster. The RPLE contains the address of the 
IICB, a register save area, 2 linkage to other RPLs in the ISAM Interface 
RPL pool, and a pointer to the SAM DECB. 


Request Parameter List Extension (RPLE)—Description and Format 


A Offset 
0 (0) 
4 (4) 


Bytes and 
Bk Pattern 


4 
4 


Field Name 


RPLOPT3 


RPLEODS 
RPLSFORM 
RPLBLK 


RPLVFY 
RPLFLD 
RPLFMT 


RPLALIGN 


RPLOPT4 


RPLNXTRP 
RPLCHAIN 


RPLRLEN 
RPLBUFL 


RPLRBAR 
RPLAIXPC 
RPLAIXID 
RPLAXPKP 


RPLDDDD 


RPLACTIV 
RPLEMLEN 
RPLERMSA 


Field Name 
RPLIICB 
RPLDECB 


Description 
Option flag byte 3: 


End of the user’s output data set 
Spool form on remote 

Block the records 

The records are unblocked 
UCS/FCB verify 

UCS fold 

Format type: 

UCS load 

FCB load 

Reserved 

Reserved 

Align the buffer and notify the operator 
Do not align the FCB buffer loads 


Reserved 
Address of the next RPL in the chain 


Length of the record 

Length of the user's buffer 
Reserved 

RBA return location 
Alternate-index pointer count 
Alternate-index pointer type: 


Pointer is: 

0 Prime-key pointer 
1 RBA pointer 
Reserved 


Reserved 

Relative byte address 
Reserved 

CHECK not issued 
Error message length 


Address of the error message area 


Description 
Address of the ICB 


Address of the DECB—f the field contains 
zeros, the RPL has not been assigned to a 
DECB (BISAM only) 
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8 (8) 


12 (C) 


16 (10) 


1711) 
20 (14) 
24 (18) 


SRB—Service Request Block 


RPLIIBFR 


RPLRPLPT 


RPLITTSB 


RPLSAVE 
RPLSAVE2 


Address of the ISAM Interface buffer 

associated with the RPL (the buffer is 

required for locate mode processing, data 

only retrieval, dynamic buffering, and ; 
BISAM stand-alone write) | 


Address of the next RPL in the ISAM fe 
Interface RPL pool—if the RPL is the last 
RPL in the pool, this field contains zeros 


Test-and-set (TS) byte—this field is used to 
indicate the assignment of the RPL to a 
BISAM DECB 


Reserved 
Register save area 


Register save area 


The SRB is used by the VS2 I/O Supervisor to dispatch I/O processing for a 
request. It identifies the address space in which processing is to be done. 


The format of the SRB is given in OS/VS2 Data Areas. 


SSL—Swap Save List 


The SSL contains up to 16 entries that identify control blocks that are to be 
chained after Open has otherwise completed successfully. Deferring chaining 
makes it unnecessary to unchain the control blocks should Open fail. 


Open uses the Compare-and-Swap instruction to chain or alter storage that is 
subject to simultaneous alteration by two or more tasks. 


. The SSL is pointed to by OPWA (called the ACB work area). Additional € 


SSLs are chained as required. 


Swap Save List (SSL)—Description and Format 


0 (0) 
1 (1) 
4 (4) 
12 (C) 


16 (10) 
18 (12) 
20 (14) 
20 (14) 


24 (18) 


S : 
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Bytes and 
Offset Bi Pattera 


1 
3 
8 
4 


Field Name 
SSLSUBPL 
SSLLENTH 
SSLID 
SSLNXPTR 


SSLACEN 


SSLENTRY 
SSLSWPTR 


SSLSWAP 


\ Ba 
“ee 


Description 

Subpool number of the SSL 
Length of the SSL 
Identifier: ‘6IDASSLBb’ 


Address of the next SSL (zero for the last 
SSL in the chain) 


Number of active entries 
Reserved 
Entries for control blocks to be chained: 


Address of the word in which SSLSWAP is to 
be placed 


The value that is to be placed at the address 
given is SSLSWPTR 


